okx-cex-skill-mp

OKX Skills Marketplace

在 OKX Skills Marketplace 中浏览、搜索、安装和管理 AI 交易技能。技能是模块化的 AI 提示词包，可扩展交易助手的能力，涵盖市场分析、交易执行、风险管理和投资组合优化。

⚠️ 第三方内容声明 OKX Skills Marketplace 上提供的技能由独立第三方开发者创建并发布，而非由 OKX 创建。OKX 不会编写、审核、认可或对任何第三方技能的内容、准确性或行为负责。使用前务必查看技能的 SKILL.md，并且只安装来自可信作者的技能。 通过 okx skill add 安装技能时，技能会从 Marketplace 下载并保存到 Agent 的技能目录中（例如 ~/.agents/skills/<skill-name>/）。该技能完全在本地计算机上运行，并拥有 Agent 的全部权限——请像安装任何第三方软件一样谨慎对待。

技能路由

• 技能 Marketplace → okx-cex-skill-mp（此技能）
• 市场数据 / 指标 → okx-cex-market
• 账户余额 / 持仓 → okx-cex-portfolio
• 下单 / 撤单 → okx-cex-trade
• 网格 / DCA 机器人 → okx-cex-bot

前提条件

1. 安装 okx CLI：

   npm install -g @okx_ai/okx-trade-cli
   

2. 配置 API 凭据（访问 Marketplace 所必需）：

   okx config init
   

---

安装策略

用户想要安装技能时，严格按以下顺序操作：

1. 始终先尝试 okx skill add <name>——此命令会下载技能，并一步将其安装到所有检测到的 Agent（Claude Code、OpenClaw、Cursor、Windsurf 等）。
2. 只有在 add 失败时，才回退到手动下载：
   • 告知用户 add 失败的原因（网络错误、npx 不可用、权限问题等）
   • 提供 okx skill download <name> --dir <path> 作为替代方案
   • 指引用户手动解压，并将文件放入 Agent 的技能目录

除非 add 已经失败，否则绝不能跳过 add，直接使用 download。

---

命令参考

#	命令	说明
1	okx skill search <keyword>	按关键词搜索 Marketplace
2	okx skill search --categories <id>	按类别筛选技能
3	okx skill categories	列出所有可用类别
4	okx skill add <name>	下载并安装到所有检测到的 Agent
5	okx skill download <name> [--dir <path>] [--format zip|skill]	下载软件包（默认格式：zip）
6	okx skill list	列出本地已安装的技能
7	okx skill check <name>	检查是否有更新版本
8	okx skill remove <name>	卸载技能
9	okx skill verify <name>	按需重新验证已安装技能的签名

在任何命令后添加 --json，即可输出原始 JSON。在任何命令后添加 --env，即可将输出包装为 {"env", "profile", "data"}。

---

命令详解

1. 搜索技能

okx skill search grid

输出：

  NAME              VERSION   DESCRIPTION
  grid-premium      1.2.0     Enhanced grid trading with technical analysis
  grid-dca          1.0.0     Grid strategy combined with DCA

2 skills found (page 1/1). Use `okx skill add <name>` to install.

按类别筛选搜索：

okx skill search --categories trading-strategy

分页（响应中包含表示总页数的 totalPage）：

okx skill search grid --page 2 --limit 5
# Output: "3 skills found (page 2/4). Use `okx skill add <name>` to install."

2. 浏览类别

okx skill categories

输出：

  ID                  NAME
  trading-strategy    Trading Strategy
  risk-management     Risk Management
  analysis            Market Analysis

3. 安装技能

okx skill add grid-premium

输出：

Downloading grid-premium...
Verifying signature...
  Signature verified (key: okx-skill-signing-key-2026, files: 3)
Installing to detected agents...
✓ Skill "grid-premium" v1.2.0 installed
  Note: This skill was created by a third-party developer, not by OKX. Review SKILL.md before use.

底层执行的操作：

1. 从 OKX Marketplace API 下载技能 zip 文件
2. 解压并验证软件包（检查 SKILL.md 是否存在，并读取元数据）
3. 验证 Ed25519 签名和 SHA-256 文件完整性——验证失败时会阻止安装
4. 运行 npx skills add，将技能安装到所有本地检测到的 Agent
5. 将安装记录（包括验证状态）保存到 ~/.okx/skills/registry.json

强制安装（跳过验证）：

okx skill add grid-premium --force

⚠️ 安全警告：--force 会跳过签名验证，即使验证失败也会安装技能。仅在信任来源并了解风险时使用。此绕过操作会以 bypassed 状态记录在注册表中。

4. 仅下载（不安装）

当 add 失败或用户想要原始软件包时：

okx skill download grid-premium --dir ~/Downloads/

输出：

✓ Downloaded grid-premium.zip
  Path: /Users/me/Downloads/grid-premium.zip

要下载为 .skill 格式（供可识别此扩展名的 Agent 使用）：

okx skill download grid-premium --dir ~/Downloads/ --format skill

压缩包包含：

• SKILL.md — 技能的主要指令文件
• _meta.json — 元数据（名称、版本、标题、描述）
• reference/ — 可选的支持文档

5. 列出已安装的技能

okx skill list

输出：

  NAME              VERSION   INSTALLED AT
  grid-premium      1.2.0     2026-03-25 10:30:00
  dca-smart         2.1.0     2026-03-20 14:00:00

2 skills installed.

6. 检查更新

okx skill check grid-premium

输出：

grid-premium: installed v1.0.0 → latest v1.2.0 (update available)
  Use `okx skill add grid-premium` to update.

要更新，只需再次运行 okx skill add <name> — 它会覆盖之前的版本。

7. 移除技能

okx skill remove grid-premium

输出：

✓ Skill "grid-premium" removed

8. 验证技能签名

无需重新安装，即可对已安装的技能重新运行签名验证：

okx skill verify grid-premium

输出（成功）：

✓ grid-premium: signature verified (key: okx-skill-signing-key-2026, files: 3)

输出（失败）：

✗ grid-premium: verification failed — Invalid signature

• 失败时退出代码为 1。
• 结果会保存回 ~/.okx/skills/registry.json。
• 使用 --json 获取机器可读输出。

---

MCP 工具（替代方案）

当 CLI 不可用时（例如，无法访问终端的 Claude Desktop），可通过 MCP 工具使用相同的市场功能：

MCP 工具	对应的 CLI	描述
skills_search	okx skill search	按关键词／类别搜索。响应中包含用于分页的 totalPage。
skills_get_categories	okx skill categories	列出类别
skills_download	okx skill download	将软件包下载到目录（默认格式：.skill；传入 format: "zip" 可下载为 zip）

注意：MCP 工具仅支持搜索和下载。完整的安装流程（add）需要访问 CLI。

---

错误处理

错误	含义	操作
70002 SKILL_DELETED	技能已从市场中移除	选择其他技能
70003 NO_APPROVED_VERSION	没有可用的已批准版本	技能正在等待审核，请稍后再试
70030 VERSION_NOT_APPROVED	该版本尚未获准下载	等待审核，或使用较旧版本
50111/50112/50113	身份验证错误	运行 okx config init 设置凭据
npx skills add 失败	npx 不可用或存在网络问题	改用 okx skill download，然后手动安装