OKX OnChainOS — 技能目錄 是做什麼的？
本檔案是什麼： 指向 OKX 官方
onchainos-skills倉庫的目錄頁面。它本身不包含任何邏輯 — 下列每個子技能都源自okx/onchainos-skills上游倉庫，並在安裝時獲取最新版本，因此您永遠能獲得最新版本。
OKX OnChainOS 是一套8 個專門的子技能，涵蓋鏈上交易、市場分析、聰明錢訊號、DeFi 投資與持倉、錢包操作、安全掃描、支付協議、代理身份與任務市場，以及加密貨幣新聞與情緒分析，並支援 20 多條區塊鏈（Ethereum、Solana、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
錢包 — 預設使用使用者的 Agent Wallet
使用平台的 wallet 技能進行簽署與廣播。OKX DEX 端點會回傳未簽署的 calldata（{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 req/min
- 設定：無
- 限制：僅限資料 — 無法發送交易或管理錢包
路徑 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=<您的金鑰> export OKX_SECRET_KEY=<您的密鑰> export OKX_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 App / 擴充功能錢包。
按類別排列的子技能
📊 探索與市場資料（2 個）
| 子技能 | 用途 |
|---|---|
okx-dex-market | 唯讀鏈上 DEX 資料：即時價格 / K 線 / 指數 / 錢包盈虧、地址追蹤器活動、聰明錢 / 巨鯨 / KOL 訊號追蹤 + 排行榜排名、代幣搜尋 / 元數據 / 市值 / 排名 / 流動性 / 熱門代幣 / 持有者與集群分析 / 頂級交易者 / 交易歷史、加密貨幣新聞 / 情緒 / 氛圍 / KOL 排行榜、Meme 幣拉盤 / 坑道掃描 / 開發者聲譽 / 捆包偵測，以及 WS/腳本即時串流 |
okx-dapp-discovery | 第三方 DApp 探索與直接外掛路由 — 目前支援 Polymarket、Aave V3、Hyperliquid、PancakeSwap V3 AMM、Morpho V1 Optimizer |
💼 錢包、交易與安全（1 個）
| 子技能 | 用途 |
|---|---|
okx-agentic-wallet | 錢包生命週期（驗證、餘額、投資組合盈虧、發送、交易歷史、合約呼叫）、加油站、DEX 交換、跨鏈橋接、限價單策略、交易閘道（Gas / 模擬 / 廣播 / 追蹤訂單）、公開地址投資組合、安全掃描（代幣風險、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 | Agentic Wallet 專屬交易競賽：列表、加入、查看排行榜、領取獎勵 |
快速任務 → 子技能對照表
| 我想… | 子技能 | 建議路徑 |
|---|---|---|
| 檢查代幣價格或圖表 | okx-dex-market | A（無需金鑰） |
| 搜尋 / 分析代幣的持有者 | okx-dex-market | A（無需金鑰） |
| 跟隨聰明錢買入 | okx-dex-market | A（無需金鑰） |
| 掃描新 Meme 幣發行 | okx-dex-market | A（無需金鑰） |
| 查看任何公開錢包 | okx-agentic-wallet（公開地址投資組合） | A（無需金鑰） |
| 掃描代幣 / DApp 的風險 | okx-agentic-wallet（安全掃描） | A（無需金鑰） |
| 估算 Gas / 模擬交易 | okx-agentic-wallet（閘道） | A 或 B |
| 管理 / 從我的錢包發送 | okx-agentic-wallet | B（需要登入） |
| 交換代幣 | okx-agentic-wallet（DEX 交換）REST + 使用 wallet 技能（Agent 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 <addr> |
| Daily Brief | 市場脈動 + 聰明錢 + 新代幣活動 + 投資組合警報 | — |
| Smart Money Signals | 按代幣匯總的聰明錢訊號清單 + 每個代幣的盡職調查 | onchainos workflow smart-money |
| New Token Screening | MIGRATED 發射台掃描 + 前 10 名的安全性與開發者豐富化 | onchainos workflow new-tokens |
| Wallet Analysis | 7 天 / 30 天盈虧、交易行為、近期鏈上活動 | onchainos workflow wallet-analysis --address <addr> |
| Portfolio Check | 餘額、總價值、30 天盈虧概覽 | onchainos workflow portfolio --address <addr> |
| Wallet Monitor | 會話內輪詢 — 監控錢包的新交易時發出警報 | — |
| Wallet Monitor (WS) | 用於離線錢包監控的背景 WebSocket 會話 | — |
複合 CLI 指令
取代多次個別工具呼叫的單一指令：
# 代幣報告：資訊 + 價格 + 進階資訊 + 安全掃描（並行）
onchainos token report --address <addr> --chain solana
# 完整工作流程指令
onchainos workflow token-research --address <addr> [--chain solana]
onchainos workflow smart-money [--chain solana]
onchainos workflow new-tokens [--chain solana] [--stage MIGRATED]
onchainos workflow wallet-analysis --address <addr> [--chain ethereum]
onchainos workflow portfolio --address <addr> [--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（按盈虧/勝率排列的頂級交易者 + 代幣分析）→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 金鑰。
- 交易與發送預設使用使用者的 Agent Wallet，透過
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