OKX OnChainOS 是一套围绕链上操作的技能集合，以目录形式分发，实际内容全部来自上游 okx/onchainos-skills 仓库，安装时实时拉取最新版本。整体覆盖 20 多条区块链，包括 Ethereum、Solana、XLayer、Base、BSC、Arbitrum、Polygon、Optimism、Avalanche、TRON 等。
一、用途与组成
套件由 8 个专门子技能构成，分为以下几类：
-
发现与市场数据：okx-dex-market 提供只读链上 DEX 数据，包括实时价格、K 线、指数、钱包盈亏、地址追踪活动、聪明钱／巨鲸／KOL 信号追踪与排行榜、代币搜索与元数据、市值、排名、流动性、热门代币、持有人与集群分析、顶级交易者、交易历史、加密新闻与情绪、meme 打新扫描、开发者声誉、捆绑检测，以及 WebSocket/脚本实时流。okx-dapp-discovery 提供第三方 DApp 发现与插件路由，目前支持 Polymarket、Aave V3、Hyperliquid、PancakeSwap V3 AMM、Morpho V1 Optimizer。
-
钱包、交易与安全：okx-agentic-wallet 覆盖钱包生命周期（认证、余额、组合盈亏、发送、交易历史、合约调用）、加油站、DEX 兑换、跨链桥、限价单策略、交易网关（gas、模拟、广播、订单追踪）、公开地址组合、安全扫描（代币风险、DApp 钓鱼、交易与签名检查、授权）、审计日志。
-
DeFi：okx-defi 聚合 DeFi 产品发现、存款、取款、领取奖励，覆盖 Aave、Lido、PancakeSwap、Kamino、NAVI 等，并提供跨协议与跨链的持仓总览。
-
支付：okx-agent-payments-protocol 为统一支付调度器，支持 x402（exact / aggr_deferred 方案，TEE 或本地密钥签名）、MPP（charge / session 意图，open / voucher / topUp / close，交易或哈希模式）、a2a-pay（基于 paymentId 的创建、支付、状态查询）。
-
智能体与 AI：okx-ai 提供 ERC-8004 链上 Agent 身份（注册、更新、搜索、评分、服务列表）、智能体任务市场（发布、接单、交付、争议）与实时任务进度监控。okx-guide 为入门与指南中心，包含 Onchain OS 入门与欢迎横幅、OKX.AI 介绍与角色注册路由、客服与帮助中心指引。
-
运维：okx-growth-competition 提供 Agentic Wallet 专属交易竞赛的列表、加入、排行榜查看与奖励领取。
二、使用方式
安装单个子技能（推荐，只拉取所需内容）： npx skills add okx/onchainos-skills@<sub-skill-name>
或使用长格式： npx skills add https://github.com/okx/onchainos-skills --skill <sub-skill-name>
安装全部（自动检测环境）： npx skills add okx/onchainos-skills
也可通过插件市场： /plugin marketplace add okx/onchainos-skills /plugin install onchainos-skills
CLI 安装（onchainos 二进制，自动检测平台、校验 SHA256）：
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
认证有两条路径：
路径 A：通过 Starchild sc-proxy 直接 HTTP，无需 API Key。适用于只读数据查询（价格、K 线、聪明钱信号、代币分析、安全检查、公开地址组合等约 80% 能力）。示例： 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 Key 的 onchainos CLI。适用于钱包操作（登录、发送、合约调用）、需执行的 DEX 兑换、支付等 CLI 工作流。CLI 自带沙箱 API Key 可用于本地测试，但为共享、限速、仅评估用途，不得用于生产或真实资产。生产环境需在 web3.okx.com → OnchainOS → Dev Portal 申请凭据，并设置环境变量： export OKX_API_KEY=<your key> export OKX_SECRET_KEY=<your secret> export OKX_PASSPHRASE=<your passphrase>
CLI 无法使用 sc-proxy，原因是 onchainos 二进制使用 Rust rustls TLS 栈与内置 webpki-roots，忽略系统信任库与 SSL_CERT_FILE，因此拒绝 sc-proxy 的 MITM CA。
钱包方面：默认使用用户的 Agent Wallet 通过平台钱包技能签名与广播，OKX DEX 端点返回未签名 calldata（{to, value, data, ...}），将其传入 wallet_transfer(data=<calldata>) 即可，无需单独的 OKX 钱包。仅在用户明确要求时才使用 OnchainOS TEE 钱包（onchainos wallet login <email>）。
三、工作流与复合命令
仓库在 workflows/ 下提供多技能编排，智能体读取 workflows/INDEX.md 路由请求后按步骤执行。包括 Token Research（价格、安全、持有人、集群、聪明钱信号，可选打新深度分析）、Daily Brief（市场脉搏、聪明钱、新代币活动、组合警报）、Smart Money Signals（按代币聚合的 SM 信号列表及逐币尽调）、New Token Screening（MIGRATED 打新扫描加安全与开发者信息补充）、Wallet Analysis（7 天/30 天盈亏、交易行为、近期链上活动）、Portfolio Check（余额、总价值、30 天盈亏）、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]
四、典型流程与 MCP
典型流程包括：搜索与购买（okx-dex-market 找代币 → okx-agentic-wallet 检查资金并执行交易）、组合总览、市场研究、兑换与广播、完整交易流、排行榜到研究到交易、跟随聪明钱。
onchainos CLI 同时是原生 MCP 服务器，可通过 onchainos mcp 启动，向任何兼容 MCP 的客户端暴露工具。
五、重要说明与限制
链标识符接受人类可读名称（ethereum、solana、xlayer）与数字 ID，可通过 onchainos swap chains 或 onchainos gateway chains 查看完整列表。只读操作无需用户提供 API Key。交易与发送默认走用户 Agent Wallet。安全门：当 okx-agentic-wallet 的安全扫描报告失败时，调用智能体必须阻止相关操作。
入门、OKX.AI 介绍与客服支持可通过 okx-guide 使用（路径 A，无需密钥）；接入竞赛需钱包（路径 B）；CLI 失败调试可通过 okx-agentic-wallet 的审计日志（路径 B，本地 CLI 日志）。钱包登录创建的是全新 TEE 管理账户，不会导入已有的 OKX App 或插件钱包。
相关资源：上游仓库 okx/onchainos-skills；OnchainOS 文档位于 OKX Web3 Build — OnchainOS；技能注册表 skills.sh/okx/onchainos-skills；开发者门户（API Key）web3.okx.com/onchain-os/dev-portal。