> For the complete documentation index, see [llms.txt](https://minara.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://minara.ai/docs/minara-handbook/ko/trade/minara-skills.md). # 기능 ## Minara Skills란 무엇인가요? Minara Skills는 호환되는 모든 AI 에이전트에 암호화폐 및 주식 거래, 온체인 실행, 시장 인텔리전스 접근 권한을 제공하는 공식 스킬 팩입니다. 설치하면 에이전트가 자연어로 대화하는 것만으로 암호화폐, 미국 주식, 원자재, 외환을 분석하고 거래할 수 있으며, EVM, Solana, Hyperliquid 전반에서 온체인 거래를 실행하고, 지갑 및 신용카드 온램프를 관리하며, 실시간 시장 인텔리전스를 불러올 수 있습니다. Minara Skills는 다음 위에서 작동합니다 [Minara CLI](https://www.npmjs.com/package/minara) 그리고 다음을 위한 즉시 사용 가능한 패키지로 제공됩니다 [Claude Code](https://claude.com/claude-code), [OpenClaw](https://docs.openclaw.ai/tools/skills), 그리고 [Hermes](https://hermes-agent.nousresearch.com/). **Minara Skills로 할 수 있는 일:** * 티커, 토큰 이름 또는 컨트랙트 주소로 19개 네트워크 전반의 스팟 자산을 매수, 매도, 스왑, 전환, 전송 * 레버리지, 멀티월렛 관리, AI 오토파일럿을 사용해 Hyperliquid에서 무기한 선물 포지션을 개설 및 청산 * 스팟 및 perps 지정가 주문을 제출, 등록, 취소 * 스팟 및 perps 지갑 간에 입금, 출금, 전송을 수행하고, MoonPay를 통한 신용카드 온램프도 포함 * 온체인 데이터, 토큰 펀더멘털, 고래 흐름, 트렌딩 토큰과 주식, 주식 리서치, 원자재, 외환을 불러오기 * 결제 [x402](https://www.x402.org/)지원 HTTP API를 Minara 지갑에서 직접 결제 * Minara 구독, 크레딧, 프리미엄 플랜을 관리 *** ## Minara Skills는 누구를 위한 것인가요? | 사용자 유형 | 경험 수준 | 사용 방법 | | --------------- | ----------------------------------------- | ----------------------------------------------------------------------------------------------- | | **개인 투자자** | 상관없음 | 에이전트와 평이한 영어로 대화하세요: *"100 USDC로 ETH 매수"*, *"ETH 무기한 선물 롱 5배"*, *"오늘 뭐가 트렌드인가요?"* | | **고급 사용자 및 퀀트** | CLI 사용에 익숙함 | 기반 CLI를 직접 사용하여 [Minara CLI](https://www.npmjs.com/package/minara) 스크립팅, 배치 작업, 재현 가능한 워크플로를 수행 | | **에이전트 개발자** | Claude Code, OpenClaw 또는 Hermes 기반으로 구축 중 | 스킬 팩을 에이전트의 스킬 디렉터리에 넣고, 글루 코드 없이 Minara를 1급 도구로 호출하세요 | *** ## 접속 방법 Minara Skills는 GitHub를 통해 배포됩니다: [github.com/Minara-AI/skills](https://github.com/Minara-AI/skills). 해당 런타임용 원클릭 설치 프로그램으로 지원되는 세 개의 에이전트 런타임(Claude Code, OpenClaw 또는 Hermes) 중 하나에 설치한 다음 `Minara에 로그인` 을 에이전트 내부에서 실행해 인증하세요. 필요한 것: * Claude Code, OpenClaw 또는 Hermes의 정상 설치본 * Node.js (다음 용도: `npm install -g minara`) * Minara 계정 ([minara.ai](https://minara.ai)) *** ## 설치 에이전트에 맞는 설치 프로그램을 선택하세요. 각 원클릭 스크립트는 npm에서 Minara CLI를 설치하고, 스킬 파일을 에이전트의 스킬 디렉터리로 복사하며, 로그인 흐름을 시작합니다. ### Claude Code 다음 프롬프트를 Claude Code 에이전트에 보내세요: ``` "curl -fsSL https://raw.githubusercontent.com/Minara-AI/skills/main/scripts/claudecode-minara-skill-setup.sh | bash"를 실행해 Minara CLI와 Minara Skills를 설치하고 다음 구성을 설정하세요. 안내되면 로그인 URL을 따라가세요. ``` 이렇게 하면 Minara CLI가 전역으로 설치되고, 스킬이 다음 위치로 복사됩니다 `~/.claude/skills/minara`그리고 브라우저에서 로그인 URL이 열립니다. **수동 설치:** ```bash npm install -g minara@latest git clone https://github.com/Minara-AI/skills.git /tmp/minara-skills cp -r /tmp/minara-skills/skills/minara ~/.claude/skills/minara ``` ### OpenClaw 다음 프롬프트를 OpenClaw 에이전트에 보내세요: ``` "curl -fsSL https://raw.githubusercontent.com/Minara-AI/skills/main/scripts/openclaw-minara-skill-setup.sh | bash"를 실행해 Minara CLI와 Minara Skills를 설치하고 다음 구성을 설정하세요. 안내되면 로그인 URL을 따라가세요. ``` 이렇게 하면 CLI가 설치되고, 스킬이 다음 위치로 복사되며 `~/.openclaw/skills/minara`에 등록되고 `openclaw.json`에서 로그인 흐름이 시작됩니다. **ClawHub:** ```bash clawhub install lowesyang/minara ``` **수동 설치:** 리포를 복제하고 `skills/minara` 를 OpenClaw 작업 공간에 복사한 다음 스킬을 다음에 추가하세요 `~/.openclaw/openclaw.json`: ```json { "skills": { "entries": { "minara": { "enabled": true } } } } ``` ### Hermes 다음 프롬프트를 Hermes 에이전트에 보내세요: ``` "curl -fsSL https://raw.githubusercontent.com/Minara-AI/skills/main/scripts/hermes-minara-skill-setup.sh | bash"를 실행해 Minara CLI와 Minara Skills를 설치하고 다음 구성을 설정하세요. 안내되면 로그인 URL을 따라가세요. ``` 이렇게 하면 Minara CLI가 설치되고, 스킬이 다음 위치로 복사되며 `~/.hermes/skills/minara`로그인 흐름이 시작됩니다. 모든 설정 스크립트는 멱등적입니다. ClawHub → GitHub → clawhub CLI의 3단계 스킬 다운로드 폴백을 지원합니다. *** ## 첫 실행 워크플로 설치가 끝까지 제대로 되었는지 가장 빠르게 검증하는 방법입니다. 세 개의 명령으로 새 설치에서 첫 거래까지 진행할 수 있습니다. {% stepper %} {% step %} **로그인** 에이전트에게 다음을 말하세요: *"Minara에 로그인"*. 에이전트가 CLI 로그인 명령을 실행하고 브라우저 탭을 엽니다. Minara 계정으로 인증하면 CLI가 세션을 로컬에 저장합니다. {% endstep %} {% step %} **지갑에 자금 충전** 에이전트에게 다음을 말하세요: *"내 Minara 입금 주소 보여줘"* 기존 암호화폐를 입금하려면, 또는 *"신용카드로 암호화폐 구매"* MoonPay를 통해 온램프하세요. perps를 거래하려면 다음을 이어서 말하세요: *"500 USDC를 perps로 입금"* 스팟에서 Hyperliquid perps 지갑으로 자금을 옮깁니다. {% endstep %} {% step %} **거래** 원하는 것을 에이전트에게 말하세요: *"100 USDC어치 ETH 매수"*, *"0.1 ETH를 USDC로 스왑"*또는 *"ETH perps 롱, 5배 레버리지"*. 에이전트는 실행 전에 거래 세부 정보를 확인합니다. 다음을 검토하세요: **위험 고지** 를 승인하기 전에 주의 깊게 읽으세요. {% endstep %} {% endstepper %} *** ## 스팟 거래 스팟 거래는 모든 [지원 네트워크](#supported-networks). 자산은 티커(`ETH가`, `SOL이`), 이름(`ethereum`), 또는 컨트랙트 주소로 참조할 수 있습니다. **예시:** * *"100 USDC어치 ETH 매수"* * *"내 SOL 전부 매도"* * *"Base에서 0.1 ETH를 USDC로 스왑"* * *"50 USDC를 0xabc...로 전송"* 에이전트는 지갑 잔액과 자산을 바탕으로 적절한 네트워크와 라우팅을 선택합니다. *** ## 무기한 선물 무기한 선물은 Hyperliquid를 통해 라우팅됩니다. 포지션을 개설 및 청산하고, 레버리지를 설정하며, 여러 지갑을 관리하고, 거래 내역을 볼 수 있습니다. **예시:** * *"ETH perps 롱"* * *"BTC 숏, 10배 레버리지"* * *"내 ETH 포지션 청산"* * *"내 perps 내역 보여줘"* ### AI 오토파일럿 오토파일럿은 전략에 따라 에이전트가 여러분 대신 perps 포지션을 관리하도록 합니다. 다음으로 활성화하세요: *"perps에 AI 오토파일럿 활성화"*오토파일럿은 여러분이 허용한 범위 내에서만 동작하며, 언제든 비활성화할 수 있습니다. > **위험:** 무기한 선물은 레버리지 상품입니다. 손실은 초기 증거금을 초과할 수 있습니다. 오토파일럿을 활성화하거나 레버리지 포지션을 개설하기 전에 위험 고지 내용을 검토하세요. *** ## 지정가 주문 지정가 주문은 스팟과 perps 모두에서 사용할 수 있습니다. 주문을 제출하고, 열려 있는 주문을 나열하며, ID로 취소할 수 있습니다. **예시:** * *"가격이 3000달러에 도달하면 ETH 매수"* * *"150달러에 SOL 매수"* * *"내 지정가 주문 나열"* * *"지정가 주문 \[id] 취소"* *** ## 지갑 및 자금 | 작업 | 예시 프롬프트 | | ----------------- | ------------------------------------------------- | | **잔액 확인** | *"내 잔액은 얼마야?"* / *"내 암호화폐 포트폴리오 보여줘"* | | **입금** | *"내 입금 주소 보여줘"* / *"신용카드로 암호화폐 구매"* | | **스팟 ↔ Perps 전송** | *"500 USDC를 perps로 입금"* / *"perps에서 200 USDC 출금"* | | **온체인 출금** | *"\[주소]로 10 SOL 출금"* | | **결제** | *"\[주소]에 100 USDC 결제"* | 신용카드 온램프는 MoonPay를 사용합니다. 외부 주소로의 출금은 온체인으로 처리되며 표준 네트워크 수수료가 부과됩니다. *** ## 시장 인텔리전스 Minara Skills는 Minara의 전체 시장 인텔리전스 스택을 에이전트에 제공합니다. 실시간 온체인 데이터, 토큰 펀더멘털, 고래 흐름, 트렌딩 토큰과 주식, 주식 리서치, 원자재, 외환을 포함합니다. **예시:** * *"어떤 토큰이 트렌드인가요?"* * *"SOL 토큰 검색"* * *"ETH의 고래 흐름을 보여줘"* * *"NVDA 전망은 어떤가요?"* * *"현재 금 가격"* *** ## x402 결제 Minara Skills는 결제할 수 있습니다 [x402](https://www.x402.org/)지원 HTTP API를 Minara 지갑에서 직접 결제할 수 있습니다. 이를 통해 API 키나 충전 처리를 따로 하지 않고도 에이전트가 유료 API를 호출할 수 있습니다. CLI가 x402 핸드셰이크를 처리하며, 유료 호출이 정산되기 직전에만 에이전트가 확인을 요청합니다. *** ## 프리미엄 에이전트 내부에서 Minara 구독, 크레딧 잔액, 플랜을 관리하세요. **예시:** * *"내 크레딧 보여줘"* * *"Minara 플랜 업그레이드"* * *"내 플랜은 무엇인가요?"* *** ## 지원 네트워크 스팟 거래 및 온체인 작업은 다음에서 지원됩니다: Ethereum, Base, Arbitrum, Optimism, Polygon, Avalanche, Solana, BSC, Berachain, Blast, Manta, Mode, Sonic, Conflux, Merlin, Monad, Polymarket, XLayer. 무기한 선물은 Hyperliquid를 통해 라우팅됩니다. *** ## 벤치마크 Minara Skills는 다음 점수를 기록했습니다 **88/100** 에서 [crypto-skill-bench](https://github.com/Minara-AI/crypto-skill-benchmark) v3.0.2, Claude Sonnet 4.6에서 76개 시나리오로 평가됨. | 항목 | 점수 | | ---- | -- | | 안전성 | 91 | | 커버리지 | 86 | | 견고성 | 88 | | 라우팅 | 88 | | UX | 86 | 66개 시나리오 통과, 10개 부분 통과, 0개 실패. 안전성 게이트: 통과. 이 벤치마크는 오픈소스입니다. 실행을 재현하고, 모든 시나리오를 검토하고, 다른 스킬 팩과 비교할 수 있습니다. *** ## Minara Skills가 할 수 있는 것과 할 수 없는 것 ### 정의할 수 있는 것 * 에이전트 런타임(Claude Code, OpenClaw 또는 Hermes) * 거래할 네트워크와 자산 * perps에 AI 오토파일럿을 활성화할지, 한다면 어느 범위에서 할지 * 지정가 주문 가격, 레버리지 수준, 증거금 배분 * 온체인 입금으로 충전할지, 신용카드 온램프로 충전할지 ### 플랫폼이 제어하는 것 * 주문 라우팅 및 거래소 선택 * 네트워크 수수료 및 온체인 확인 시간 * perps의 Hyperliquid 유동성, 펀딩비, 청산 로직 * 신용카드 온램프를 위한 MoonPay의 KYC 및 가격 책정 * 스킬 버전 업데이트(다음에서 관리: `version-check.sh` 세션별) ### 현재 제한 사항 * 이 스킬은 지원되는 3개 런타임에만 묶여 있으며, 다른 에이전트 프레임워크는 아직 통합되지 않았습니다. * perps 지갑으로의 직접 입금은 지원되지 않습니다. 자금은 먼저 스팟으로 들어온 뒤 전송해야 합니다. * Hyperliquid는 perps 출금 시 1 USDT 수수료를 부과하며, 이 스킬은 이를 면제하지 않습니다. * 무기한 선물은 Hyperliquid에서만 이용할 수 있습니다. 다른 perps 거래소는 현재 라우팅되지 않습니다. * 일부 고급 주문 유형(TWAP, 아이스버그)은 자연어 프롬프트로 노출되지 않습니다. *** ## 더 나은 결과를 위한 팁 1. **금액과 자산을 구체적으로 말하세요.** *"100 USDC로 ETH 매수"* 은/는 모호하지 않습니다; *"ETH를 좀 사줘"* 그러면 추가 확인 단계가 진행됩니다. 2. **헷갈리면 네트워크 이름을 명시하세요.** *"Base에서 0.1 ETH를 USDC로 스왑"* 에이전트가 라우팅을 추론해야 하는 일을 피할 수 있습니다. 3. **승인 전에 확인하세요.** 에이전트는 실행 전에 항상 거래 세부 정보를 보여줍니다. 읽어보고, 이상하면 거절하세요. 4. **작게 시작하세요.** 실제 큰 금액을 넣기 전에 5달러 규모의 스왑으로 설치를 검증하세요. 5. **중요한 진입은 지정가 주문을 사용하세요.** 시장가 주문은 더 빠르지만 유동성이 얕은 페어에서는 정확도가 떨어집니다. 6. **CLI를 최신 상태로 유지하세요.** 다음을 실행하세요: `minara --version` 그리고 npm 버전과 비교하세요. 세션 수준의 `version-check.sh` 스크립트가 업그레이드를 자동으로 표시합니다. 7. **이해한 범위에서만 오토파일럿을 승인하세요.** 확장하기 전에 단일 자산과 작은 증거금 배분으로 시작하세요. *** ## 면책 고지 * 모든 거래에는 위험이 따릅니다. 잃어도 되는 자금으로만 거래하세요. * 무기한 선물은 레버리지 상품입니다. 손실은 초기 증거금을 초과할 수 있습니다. * Minara Skills는 에이전트가 Minara 플랫폼을 운영할 수 있게 해주는 도구입니다. 이는 금융 자문이 아닙니다. * Minara는 **하지 않습니다** 유동성을 제공하거나 거래 상대방 역할을 하지 않습니다. 스팟 라우트는 외부 거래소를 거치며, perps는 Hyperliquid에서 실행됩니다. * 최종 통제권은 사용자에게 있습니다. 언제든 오토파일럿을 비활성화하거나, 지정가 주문을 취소하거나, 자금을 출금할 수 있습니다. * 과거 벤치마크 성과가 미래 결과를 보장하지는 않습니다. *** ## 링크 * 저장소: [github.com/Minara-AI/skills](https://github.com/Minara-AI/skills) * npm의 CLI: [npmjs.com/package/minara](https://www.npmjs.com/package/minara) * 벤치마크: [github.com/Minara-AI/crypto-skill-benchmark](https://github.com/Minara-AI/crypto-skill-benchmark) * 라이선스: MIT --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://minara.ai/docs/minara-handbook/ko/trade/minara-skills.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.