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
钱包——默认使用用户的代理钱包
使用平台的 wallet 技能进行签名和广播。OKX DEX 端点返回未签名的调用数据（{to， value， data， ...}）；将其提供给 wallet_transfer(data=<调用数据>) 即可完成。无需单独使用 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=<您的密钥> 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 线 / 指数 / 钱包 PnL、地址追踪活动、聪明钱 / 巨鲸 / KOL 信号追踪 + 排行榜排名、代币搜索 / 元数据 / 市值 / 排名 / 流动性 / 热门代币 / 持有者及聚类分析 / 顶级交易者 / 交易历史、加密货币新闻 / 情绪 / 氛围 / KOL 排行榜、Meme 币 Pump / 新手扫描 / 开发者声誉 / 捆绑检测，以及 WS/脚本实时数据流 |
okx-dapp-discovery | 第三方 DApp 发现和直接插件路由——当前支持 Polymarket、Aave V3、Hyperliquid、PancakeSwap V3 AMM、Morpho V1 Optimizer |
💼 钱包、交易与安全（1 个）
| 子技能 | 用途 |
|---|---|
okx-agentic-wallet | 钱包生命周期（认证、余额、投资组合 PnL、发送、交易历史、合约调用）、Gas Station、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 的创建 / 支付 / 状态查询）。路由到特定方案/意图的参考文档。 |
🤖 代理与 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（无需密钥） |
| 扫描新 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 技能（代理钱包）签名 | |
| 寻找最佳 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 命令 |
|---|---|---|
| 代币研究 | 价格、安全性、持有者、聚类、聪明钱信号，可选的启动板深入分析 | onchainos workflow token-research --address <地址> |
| 每日简报 | 市场脉搏 + 聪明钱 + 新代币活动 + 投资组合提醒 | — |
| 聪明钱信号 | 按代币聚合的聪明钱信号列表 + 每个代币的尽职调查 | onchainos workflow smart-money |
| 新代币筛查 | 已迁移启动板扫描 + 前 10 名的安全性和开发者丰富度分析 | onchainos workflow new-tokens |
| 钱包分析 | 7 天/30 天 PnL、交易行为、近期链上活动 | onchainos workflow wallet-analysis --address <地址> |
| 投资组合检查 | 余额、总价值、30 天 PnL 概览 | onchainos workflow portfolio --address <地址> |
| 钱包监控 | 会话内轮询——监控钱包的新交易并发出警报 | — |
| 钱包监控（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（趋势/排名 + K 线/历史）→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