okx-cex-skill-mp

OKX 技能市场

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

⚠️ 第三方内容声明
OKX技能市场上的技能由独立的第三方开发者创建和发布，而非OKX。OKX不对任何第三方技能的内容、准确性或行为进行编写、审查、认可或承担责任。使用前请务必查看技能的SKILL.md，并仅安装来自您信任作者的技能。
当通过okx skill add安装技能时，它将从市场下载并保存到您本地的智能体技能目录（例如~/.agents/skills/<skill-name>/）。该技能完全在您的本地机器上以智能体的全部权限运行——请像安装任何第三方软件一样谨慎对待。

技能路由

• 技能市场 → 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凭据（需要市场访问权限）：

   okx config init
   

---

安装策略

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

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

除非 add 已失败，否则切勿跳过 add 直接使用 download。

---

命令参考

#	命令	描述
1	okx skill search <keyword>	按关键词搜索市场
2	okx skill search --categories <id>	按分类筛选技能
3	okx skill categories	列出所有可用分类
4	okx skill add <name>	下载并安装到所有检测到的智能体
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

输出：

  名称              版本    描述
  grid-premium      1.2.0    增强型网格交易，含技术分析
  grid-dca          1.0.0    网格策略结合DCA

找到2个技能（第1/1页）。使用 `okx skill add <name>` 安装。

按分类筛选搜索：

okx skill search --categories trading-strategy

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

okx skill search grid --page 2 --limit 5
# 输出："找到3个技能（第2/4页）。使用 `okx skill add <name>` 安装。"

2. 浏览分类

okx skill categories

输出：

  ID                  名称
  trading-strategy    交易策略
  risk-management     风险管理
  analysis            市场分析

3. 安装技能

okx skill add grid-premium

输出：

正在下载 grid-premium...
正在验证签名...
  签名已验证（密钥：okx-skill-signing-key-2026，文件数：3）
正在安装到检测到的智能体...
✓ 技能 "grid-premium" v1.2.0 已安装
  注意：此技能由第三方开发者创建，并非OKX。使用前请查看SKILL.md。

底层操作：

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

强制安装（绕过验证）：

okx skill add grid-premium --force

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

4. 仅下载（不安装）

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

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

输出：

✓ 已下载 grid-premium.zip
  路径：/Users/me/Downloads/grid-premium.zip

以下载 .skill 格式（适用于识别该扩展名的智能体）：

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

zip包包含：

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

5. 列出已安装技能

okx skill list

输出：

  名称              版本    安装时间
  grid-premium      1.2.0     2026-03-25 10:30:00
  dca-smart         2.1.0     2026-03-20 14:00:00

已安装2个技能。

6. 检查更新

okx skill check grid-premium

输出：

grid-premium：已安装 v1.0.0 → 最新 v1.2.0（有可用更新）
  使用 `okx skill add grid-premium` 进行更新。

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

7. 移除技能

okx skill remove grid-premium

输出：

✓ 技能 "grid-premium" 已移除

8. 验证技能签名

在不重新安装的情况下，对已安装的技能重新运行签名验证：

okx skill verify grid-premium

输出（成功）：

✓ grid-premium：签名已验证（密钥：okx-skill-signing-key-2026，文件数：3）

输出（失败）：

✗ grid-premium：验证失败 — 无效签名

• 失败时退出码为 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，然后手动安装