mcpField
O
okx

okx

github.com/starchild-ai-agent其他301.7k 次安装1 周前更新
代码仓库

关于 okx

OKX 是官方 OnchainOS 技能集合的目录技能，覆盖多个区块链上的链上市场、钱包、DeFi、支付、安全和 Agent 服务。它将任务指向专用技能与工作流；onchainos 命令行工具也可作为 MCP 服务运行。

主要功能

  1. 01八项专用 OnchainOS 子技能
  2. 02市场数据与聪明钱分析
  3. 03钱包、交易、DeFi 和支付操作
  4. 04安全检查与 Agent 市场任务
  5. 05预置的多技能工作流

适用场景

  1. 01研究代币市场和持有者活动
  2. 02查看钱包或投资组合
  3. 03执行钱包和 DeFi 操作
  4. 04筛查代币并监控钱包活动

MCP 相关

onchainos 命令行工具可通过 `onchainos mcp` 作为原生 MCP 服务运行，向兼容 MCP 的客户端提供工具。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/starchild-ai-agent/official-skills --skill okx

安装后在 Claude Code 中输入/okx确认已加载。

详细介绍

OKX OnChainOS — 技能目录

此文件的用途： 指向 OKX 官方 onchainos-skills 仓库的目录页面。此文件不包含任何自身逻辑——下方每个子技能 都位于上游的 okx/onchainos-skills 中，并会在安装时获取最新版本，因此你始终可以获得最新版本。

OKX OnChainOS 是一套包含 8 个专业子技能的工具集，涵盖链上 交易、市场分析、聪明钱信号、DeFi 投资与持仓、 钱包操作、安全扫描、支付协议、Agent 身份与任务 市场，以及覆盖 20 多条区块链（Ethereum、Solana、XLayer、Base、BSC、Arbitrum、Polygon、 Optimism、Avalanche、TRON，……）的加密新闻与情绪分析。

大多数子技能都使用单个二进制文件 onchainos，该文件会在首次 使用时下载。部分功能（只读数据）也可以不使用二进制文件，通过 Starchild 的 sc-proxy 访问——请参阅下文的身份验证选项。

安装实际如何运作

# Install one sub-skill (recommended — pulls just what you need)
npx skills add okx/onchainos-skills@<sub-skill-name>

# Or via long form
npx skills add https://github.com/okx/onchainos-skills --skill <sub-skill-name>

# Install everything (auto-detects your environment and installs accordingly)
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
# add `-s -- --beta` for the latest pre-release (opt-in only; never downgrades)

# 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>）。

身份验证选项（调用任何内容前请先阅读）

有两种不同的路径。根据 Agent 需要执行的操作进行选择：

路径 A — 通过 Starchild sc-proxy 直接使用 HTTP（无需 API Key）

对于只读数据查询（价格、K 线、聪明钱信号、代币 分析、安全检查、公开地址的投资组合——约占 OnchainOS 功能的 80 %），Agent 可以完全跳过 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 Key 的 onchainos CLI

适用于钱包操作（wallet login、wallet send、wallet contract-call）、需要执行交易的 DEX 兑换、支付以及其他由 CLI 驱动的工作流。

onchainos CLI 内置了沙盒 API 密钥，可直接用于本地测试——无需设置。这些密钥由多人共享、受速率限制， 且仅供评估使用：请勿在生产环境或涉及真实资产时使用。使用内置密钥造成的任何故障或损失，均由调用者自行承担。

生产环境请使用你自己的凭证：

  1. 前往 web3.okx.com → OnchainOS → Dev Portal 申请
  2. 设置环境变量（或在项目根目录创建 .env 文件——切勿提交该文件）： 
    export OKX_API_KEY=<your key>
export OKX_SECRET_KEY=<your secret>
export OKX_PASSPHRASE=<your passphrase>
  3. 运行任意子技能的 CLI 命令。
为什么 CLI 无法使用 sc-proxy

onchainos 二进制文件使用 Rust 的 rustls TLS 堆栈，并捆绑了 webpki-roots——一份在编译时复制的 Mozilla 根 CA 列表。它会忽略 系统信任存储和 SSL_CERT_FILE，也没有文档记录的环境变量覆盖选项。因此，sc-proxy 的 MITM CA 会被判定为 UnknownIssuer 并遭拒绝，CLI 无法通过透明代理使用。如今，要通过 OnchainOS 使用平台凭证，唯一方法是路径 A（从 Agent 脚本直接发起 HTTP 请求）。

创建钱包（onchainos wallet login <email>）会为你创建一个全新的 TEE 托管账户——它不会导入你现有的 OKX App / 扩展钱包。

按类别划分的子技能

📊 发现与市场数据（2）
子技能用途
okx-dex-market只读链上 DEX 数据：实时价格 / K 线 / 指数 / 钱包盈亏、地址追踪器活动、聪明钱 / 巨鲸 / KOL 信号追踪及排行榜、代币搜索 / 元数据 / 市值 / 排名 / 流动性 / 热门代币 / 持有者与集群分析 / 顶级交易者 / 交易历史、加密新闻 / 情绪 / 氛围 / KOL 排行榜、Meme 拉盘 / Trenches 扫描 / 开发者信誉 / Bundle 检测，以及 WS / 脚本实时流式传输
okx-dapp-discovery第三方 DApp 发现与直接插件路由——目前支持 Polymarket、Aave V3、Hyperliquid、PancakeSwap V3 AMM、Morpho V1 Optimizer
💼 钱包、交易与安全（1）
子技能用途
okx-agentic-wallet钱包生命周期（身份验证、余额、投资组合盈亏、发送、交易历史、合约调用）、Gas Station、DEX 兑换、跨链桥、限价单策略、交易网关（Gas / 模拟 / 广播 / 订单跟踪）、公开地址投资组合、安全扫描（代币风险、DApp 钓鱼、交易与签名检查、授权）、审计日志
🏦 DeFi（1）
子技能用途
okx-defiOKX 聚合 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 创建 / 支付 / 查询状态）。路由至各方案 / 意图参考文档。
🤖 Agent 与 AI（2）
子技能用途
okx-aiERC-8004 链上 Agent 身份（注册 / 更新 / 搜索 / 评分 / 服务列表）+ Agent 任务市场（发布 / 接受 / 交付 / 争议处理）+ 实时任务进度监控
okx-guide入门与指南中心：Onchain OS 入门 + 欢迎横幅、OKX.AI 简介与角色注册路由、客户支持 / 帮助中心指南
🛠️ 运维（1）
子技能用途
okx-growth-competitionAgentic Wallet 专属交易竞赛：查看列表、加入、查看排行榜、领取奖励

快速任务 → 子技能对照表

我想要……子技能建议路径
查看代币价格或图表okx-dex-marketA（无需密钥）
搜索 / 分析代币持有者okx-dex-marketA（无需密钥）
追踪聪明钱买入okx-dex-marketA（无需密钥）
扫描新上线的 Meme 代币okx-dex-marketA（无需密钥）
查看任意公开钱包okx-agentic-wallet（公开地址投资组合）A（无需密钥）
扫描代币 / dApp 的风险okx-agentic-wallet（安全扫描）A（无需密钥）
估算 Gas / 模拟交易okx-agentic-wallet（网关）A 或 B
管理 / 从自己的钱包发送资产okx-agentic-walletB（需要登录）
兑换代币okx-agentic-wallet（DEX 兑换）REST + 使用 wallet 技能（Agent Wallet）签名
查找最佳 DeFi 收益（任意协议）okx-defiB（签名）
查看我的 DeFi 仓位okx-defiA（无需密钥）
使用特定 DApp（Aave、Polymarket 等）okx-dapp-discoveryB（完整 DApp 流程）
支付访问受 x402 / MPP / a2a-pay 限制的资源okx-agent-payments-protocolB（签名）
注册 / 评价链上 Agent、Agent 任务市场okx-aiB（签名）
入门、OKX.AI 简介、客户支持okx-guideA（无需密钥）
加入交易竞赛okx-growth-competitionB（需要钱包）
调试 CLI 故障okx-agentic-wallet（审计日志）B（本地 CLI 日志）

工作流 — 预构建的多技能编排

除了单项子技能外，该仓库还在 workflows/ 下提供工作流编排，将多项技能组合成一个完整操作。Agent 会读取 workflows/INDEX.md 来路由请求，然后按照匹配的工作流文件中的分步说明执行。

工作流功能CLI 命令
代币研究价格、安全性、持有者、集群、聪明钱信号，以及可选的发射平台深入分析onchainos workflow token-research --address <addr>
每日简报市场动态 + 聪明钱 + 新代币活动 + 投资组合提醒—
聪明钱信号按代币汇总的 SM 信号列表 + 单个代币尽职调查onchainos workflow smart-money
新代币筛选MIGRATED 发射平台扫描 + 为排名前 10 的代币补充安全性和开发者信息onchainos workflow new-tokens
钱包分析7 天/30 天盈亏、交易行为、近期链上活动onchainos workflow wallet-analysis --address <addr>
投资组合检查余额、总价值、30 天盈亏概览onchainos workflow portfolio --address <addr>
钱包监控会话内轮询 — 监控的钱包有新交易时发出提醒—
钱包监控 (WS)用于离线钱包监控的后台 WebSocket 会话—
组合式 CLI 命令

可替代多个单独工具调用的单条命令：

# Token report: info + price + advanced-info + security scan (parallel)
onchainos token report --address <addr> --chain solana

# Full workflow commands
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（热门趋势/排名 + K 线/历史数据）→ 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 Key。
  • 交易和发送默认使用用户的 Agent Wallet，通过 wallet 技能执行。仅当用户提出要求时，才回退到 onchainos wallet login。
  • 安全门控：当 okx-agentic-wallet 的安全扫描报告失败时，调用该技能的 Agent 必须阻止相关操作，不得继续执行。

资源

评论

支持 Markdown