OKX OnChainOS — 스킬 디렉터리은(는) 무엇을 하나요?
이 파일의 용도: OKX 공식
onchainos-skills리포지토리를 가리키는 디렉터리 페이지입니다. 자체 로직을 포함하지 않으며, 아래의 모든 하위 스킬은 상위 저장소인okx/onchainos-skills에 있으며 설치 시 최신 버전을 가져오므로 항상 최신 버전을 사용할 수 있습니다.
OKX OnChainOS는 8개의 전문화된 하위 스킬 모음으로, 온체인 트레이딩, 시장 분석, 스마트 머니 시그널, DeFi 투자 및 포지션, 지갑 운영, 보안 스캐닝, 결제 프로토콜, 에이전트 신원 및 작업 마켓플레이스, 암호화폐 뉴스 및 센티먼트를 20개 이상의 블록체인(이더리움, 솔라나, XLayer, Base, BSC, Arbitrum, Polygon, Optimism, Avalanche, TRON 등)에서 지원합니다.
대부분의 하위 스킬은 단일 바이너리 onchainos를 사용하며, 첫 사용 시 다운로드됩니다. 일부 기능(읽기 전용 데이터)은 바이너리 없이 Starchild의 sc-proxy를 통해 접근할 수도 있습니다. 자세한 내용은 아래 인증 옵션을 참조하세요.
설치 방법
# 하위 스킬 하나 설치 (권장 — 필요한 것만 가져옴)
npx skills add okx/onchainos-skills@<하위-스킬-이름>
# 긴 형식으로 설치
npx skills add https://github.com/okx/onchainos-skills --skill <하위-스킬-이름>
# 모든 항목 설치 (환경을 자동 감지하여 설치)
npx skills add okx/onchainos-skills
각 하위 스킬은 자체 SKILL.md + 참조 문서 + 트리거 구문을 제공하므로 필요한 것만 가져올 수 있습니다.
플러그인 마켓플레이스 (대체 방법):
/plugin marketplace add okx/onchainos-skills
/plugin install onchainos-skills
CLI 설치 (onchainos 바이너리 — 플랫폼 자동 감지, SHA256 검증,
~/.local/bin 또는 %USERPROFILE%\.local\bin에 설치):
# macOS / Linux
curl -sSL https://raw.githubusercontent.com/okx/onchainos-skills/main/install.sh | sh
# 최신 프리릴리즈를 원할 경우 `-s -- --beta` 추가 (옵트인 전용; 다운그레이드되지 않음)
# Windows
irm https://raw.githubusercontent.com/okx/onchainos-skills/main/install.ps1 | iex
지갑 — 기본값은 사용자의 에이전트 지갑
서명 및 브로드캐스트에는 플랫폼의 wallet 스킬을 사용하세요. OKX DEX 엔드포인트는 서명되지 않은 호출 데이터({to, value, data, ...})를 반환합니다. 이를 wallet_transfer(data=<calldata>)에 전달하면 됩니다. 별도의 OKX 지갑이 필요하지 않습니다.
OnchainOS TEE 지갑(onchainos wallet login <email>)은 사용자가 명시적으로 요청할 때만 사용하세요.
인증 옵션 (호출 전에 반드시 읽으세요)
두 가지 경로가 있습니다. 에이전트가 수행해야 하는 작업에 따라 선택하세요.
경로 A — Starchild sc-proxy를 통한 직접 HTTP 요청 (API 키 필요 없음)
읽기 전용 데이터 조회(가격, K-라인, 스마트 머니 시그널, 토큰 분석, 보안 검사, 공개 주소 포트폴리오 — OnchainOS 기능의 약 80%)의 경우 에이전트는 CLI를 건너뛰고 sc-proxy를 통해 https://web3.okx.com/...을 직접 호출할 수 있습니다:
from core.http_client import proxied_get
r = proxied_get(
"https://web3.okx.com/api/v6/dex/aggregator/supported/chain",
headers={"SC-CALLER-ID": f"chat:{thread_id}"},
)
sc-proxy는 플랫폼 OKX 자격 증명을 자동으로 주입하고, 각 요청을 HMAC-SHA256으로 서명하며, 호출자의 Starchild 크레딧으로 청구합니다.
- 비용: 요청당 $0.001
- 속도 제한: 분당 60회
- 설정: 없음
- 제한 사항: 데이터 전용 — 트랜잭션을 보내거나 지갑을 관리할 수 없음
경로 B — 자체 OKX Web3 API 키와 함께 onchainos CLI 사용
지갑 작업(wallet login, wallet send, wallet contract-call), 실행이 필요한 DEX 스왑, 결제 및 기타 CLI 기반 워크플로우에 사용합니다.
onchainos CLI는 내장 샌드박스 API 키와 함께 제공되며 로컬 테스트에 즉시 사용할 수 있습니다 — 설정이 필요 없습니다. 이러한 키는 공유되며, 속도 제한이 있고 평가 용도로만 사용됩니다: 프로덕션이나 실제 자산에는 사용하지 마십시오. 내장 키를 사용하여 발생하는 모든 실패 또는 손실은 호출자의 책임입니다.
프로덕션의 경우 자체 자격 증명을 가져오세요:
- web3.okx.com → OnchainOS → Dev Portal에서 신청
- 환경 변수 설정 (또는 프로젝트 루트에
.env파일 — 커밋 금지):export OKX_API_KEY=<your key> export OKX_SECRET_KEY=<your secret> export OKX_PASSPHRASE=<your passphrase> - 하위 스킬의 CLI 명령어 실행
CLI가 sc-proxy를 사용할 수 없는 이유
onchainos 바이너리는 Rust의 rustls TLS 스택과 번들된 webpki-roots (Mozilla 루트 CA 목록의 컴파일 타임 복사본)를 사용합니다. 시스템 트러스트 저장소를 무시하고, SSL_CERT_FILE을 무시하며, 문서화된 환경 변수 재정의가 없습니다. 결과적으로 sc-proxy의 MITM CA는 UnknownIssuer로 거부되며 CLI를 투명하게 프록시할 수 없습니다. 경로 A(에이전트 스크립트에서 직접 HTTP)는 오늘날 OnchainOS와 함께 플랫폼 자격 증명을 사용하는 유일한 방법입니다.
지갑 생성(onchainos wallet login <email>)은 새 TEE 관리 계정을 제공합니다 — 기존 OKX 앱/확장 지갑을 가져오지 않습니다.
하위 스킬 분류
📊 디스커버리 및 시장 데이터 (2)
| 하위 스킬 | 용도 |
|---|---|
okx-dex-market | 읽기 전용 온체인 DEX 데이터: 실시간 가격 / K-라인 / 지수 / 지갑 PnL, 주소 추적기 활동, 스마트 머니 / 고래 / KOL 시그널 추적 + 리더보드 순위, 토큰 검색 / 메타데이터 / 시가총액 / 순위 / 유동성 / 핫 토큰 / 보유자 및 클러스터 분석 / 최고 트레이더 / 거래 내역, 암호화폐 뉴스 / 센티먼트 / 분위기 / KOL 리더보드, 밈 펌프 / 트렌치 스캐닝 / 개발자 평판 / 번들 감지, WS/스크립트 실시간 스트리밍 |
okx-dapp-discovery | 타사 DApp 디스커버리 및 직접 플러그인 라우팅 — 현재 Polymarket, Aave V3, Hyperliquid, PancakeSwap V3 AMM, Morpho V1 Optimizer 지원 |
💼 지갑, 트레이딩 및 보안 (1)
| 하위 스킬 | 용도 |
|---|---|
okx-agentic-wallet | 지갑 수명주기 (인증, 잔액, 포트폴리오 PnL, 전송, 트랜잭션 내역, 컨트랙트 호출), 가스 스테이션, DEX 스왑, 크로스체인 브리지, 지정가 주문 전략, 트랜잭션 게이트웨이 (가스 / 시뮬레이션 / 브로드캐스트 / 주문 추적), 공개 주소 포트폴리오, 보안 스캐닝 (토큰 위험, DApp 피싱, 트랜잭션 및 서명 확인, 승인), 감사 로그 |
🏦 DeFi (1)
| 하위 스킬 | 용도 |
|---|---|
okx-defi | OKX 집계 DeFi: 상품 디스커버리, 예금, 출금, Aave, Lido, PancakeSwap, Kamino, NAVI 등의 프로토콜에서 보상 클레임, 프로토콜 및 체인 전반의 포지션 및 보유 내역 개요 |
💸 결제 (1)
| 하위 스킬 | 용도 |
|---|---|
okx-agent-payments-protocol | 통합 결제 디스패처: x402 (exact / aggr_deferred 스킴 — TEE 또는 로컬 키 서명), MPP (charge / session 의도 — open / voucher / topUp / close, 트랜잭션 또는 해시 모드), a2a-pay (paymentId 기반 create / pay / status). 스킴/의도별 참조로 라우팅. |
🤖 에이전트 및 AI (2)
| 하위 스킬 | 용도 |
|---|---|
okx-ai | ERC-8004 온체인 에이전트 신원 (등록 / 업데이트 / 검색 / 평가 / 서비스 목록) + 에이전트 작업 마켓플레이스 (게시 / 수락 / 전달 / 분쟁) + 실시간 작업 진행 모니터 |
okx-guide | 온보딩 및 가이드 허브: Onchain OS 온보딩 + 환영 배너, OKX.AI 소개 및 역할 등록 라우팅, 고객 지원 / 헬프 센터 안내 |
🛠️ 운영 (1)
| 하위 스킬 | 용도 |
|---|---|
okx-growth-competition | 에이전틱 지갑 전용 트레이딩 대회: 목록 보기, 참가, 리더보드 보기, 보상 클레임 |
빠른 작업 → 하위 스킬 매핑
| 다음을 원한다면… | 하위 스킬 | 권장 경로 |
|---|---|---|
| 토큰 가격 또는 차트 확인 | okx-dex-market | A (키 없음) |
| 토큰 보유자 검색/분석 | okx-dex-market | A (키 없음) |
| 스마트 머니 매수 추적 | okx-dex-market | A (키 없음) |
| 새로운 밈 출시 스캔 | okx-dex-market | A (키 없음) |
| 모든 공개 지갑 확인 | okx-agentic-wallet (공개 주소 포트폴리오) | A (키 없음) |
| 토큰/dApp 위험 스캔 | okx-agentic-wallet (보안 스캐닝) | A (키 없음) |
| 가스 추정 / 트랜잭션 시뮬레이션 | okx-agentic-wallet (게이트웨이) | A 또는 B |
| 내 지갑 관리/전송 | okx-agentic-wallet | B (로그인 필요) |
| 토큰 스왑 | okx-agentic-wallet (DEX 스왑) REST + wallet 스킬로 서명 (에이전트 지갑) | |
| 최고의 DeFi 수익률 찾기 (모든 프로토콜) | okx-defi | B (서명) |
| 내 DeFi 포지션 보기 | okx-defi | A (키 없음) |
| 특정 DApp 사용 (Aave, Polymarket 등) | okx-dapp-discovery | B (전체 DApp 흐름) |
| x402 / MPP / a2a-pay 게이트 리소스 결제 | okx-agent-payments-protocol | B (서명) |
| 온체인 에이전트 등록/평가, 에이전트 작업 마켓플레이스 | okx-ai | B (서명) |
| 온보딩, OKX.AI 소개, 고객 지원 | okx-guide | A (키 없음) |
| 트레이딩 대회 참가 | okx-growth-competition | B (지갑 필요) |
| CLI 오류 디버깅 | okx-agentic-wallet (감사 로그) | B (로컬 CLI 로그) |
워크플로우 — 사전 구축된 다중 스킬 오케스트레이션
개별 하위 스킬 외에도 리포지토리는 여러 스킬을 하나의 완전한 작업으로 구성하는 workflows/ 디렉토리 아래 워크플로우 오케스트레이션을 제공합니다. 에이전트는 workflows/INDEX.md를 읽어 요청을 라우팅한 다음, 일치하는 워크플로우 파일의 단계별 지침을 따릅니다.
| 워크플로우 | 설명 | CLI 명령어 |
|---|---|---|
| Token Research | 가격, 보안, 보유자, 클러스터, 스마트 머니 시그널, 선택적 런치패드 심층 분석 | onchainos workflow token-research --address <주소> |
| Daily Brief | 시장 펄스 + 스마트 머니 + 새 토큰 활동 + 포트폴리오 알림 | — |
| Smart Money Signals | 토큰별 집계된 SM 시그널 목록 + 토큰별 실사 | onchainos workflow smart-money |
| New Token Screening | MIGRATED 런치패드 스캔 + 상위 10개에 대한 안전성 및 개발자 정보 강화 | onchainos workflow new-tokens |
| Wallet Analysis | 7일/30일 PnL, 거래 행동, 최근 온체인 활동 | onchainos workflow wallet-analysis --address <주소> |
| Portfolio Check | 잔액, 총 가치, 30일 PnL 개요 | onchainos workflow portfolio --address <주소> |
| Wallet Monitor | 세션 내 폴링 — 감시 중인 지갑의 새 거래 알림 | — |
| Wallet Monitor (WS) | 오프라인 지갑 모니터링을 위한 백그라운드 WebSocket 세션 | — |
복합 CLI 명령어
여러 개별 도구 호출을 대체하는 단일 명령어:
# 토큰 보고서: 정보 + 가격 + 고급 정보 + 보안 스캔 (병렬)
onchainos token report --address <주소> --chain solana
# 전체 워크플로우 명령어
onchainos workflow token-research --address <주소> [--chain solana]
onchainos workflow smart-money [--chain solana]
onchainos workflow new-tokens [--chain solana] [--stage MIGRATED]
onchainos workflow wallet-analysis --address <주소> [--chain ethereum]
onchainos workflow portfolio --address <주소> [--chains ethereum,solana]
일반적인 스킬 흐름
- 검색 및 구매:
okx-dex-market(토큰 찾기) →okx-agentic-wallet(자금 확인 + 거래 실행) - 포트폴리오 개요:
okx-agentic-wallet(보유 내역) →okx-dex-market(분석 및 가격 차트로 보강) - 시장 조사:
okx-dex-market(트렌딩/순위 + 캔들/내역) →okx-agentic-wallet(거래) - 스왑 및 브로드캐스트:
okx-agentic-wallet(견적 받기 → 스왑 → 브로드캐스트 → 주문 추적) - 전체 트레이딩 흐름:
okx-dex-market(검색 + 가격/차트) →okx-agentic-wallet(잔액 확인 → 스왑 → 시뮬레이션 + 브로드캐스트 + 추적) - 리더보드 → 조사 → 거래:
okx-dex-market(PnL/승률별 최고 트레이더 + 토큰 분석) →okx-agentic-wallet(거래 실행) - 스마트 머니 추적:
okx-dex-market(KOL/스마트 머니 매수 + 토큰 세부 정보 + 보유자 클러스터 + 가격 차트) →okx-agentic-wallet(거래)
MCP 서버
onchainos CLI는 기본 MCP 서버 역할을 하여 모든 MCP 호환 클라이언트에 도구를 노출합니다. 다음 명령어로 시작하세요:
onchainos mcp
중요 참고 사항
- 체인 식별자: 사람이 읽을 수 있는 이름(
ethereum,solana,xlayer)과 숫자 ID를 모두 허용합니다. 전체 목록은onchainos swap chains또는onchainos gateway chains를 실행하세요. - 읽기 전용 작업 (시장 데이터, 시그널, 보안 스캔, 공개 주소 포트폴리오)은 경로 A를 통해 사용자 제공 API 키 없이 작동합니다.
- 트레이딩 및 전송은 기본적으로
wallet스킬을 통해 사용자의 에이전트 지갑을 사용합니다. 사용자가 요청하는 경우에만onchainos wallet login으로 대체하세요. - 보안 게이트:
okx-agentic-wallet의 보안 스캔이 실패를 보고하면, 호출 에이전트는 진행하지 말고 관련 작업을 반드시 차단해야 합니다.
리소스
- 업스트림 리포지토리: okx/onchainos-skills
- OnchainOS 문서: OKX Web3 Build — OnchainOS
- 스킬 레지스트리: skills.sh/okx/onchainos-skills
- 개발자 포털 (API 키): web3.okx.com/onchain-os/dev-portal