OKX AI 交易工具怎么选:Agent Trade Kit 的 MCP、命令行和 Skills
选型篇 — 让 AI 开口之前,先决定它能不能下单
先说结论:已经在用 OKX,只想让 AI 查行情和持仓,用 MCP,并加上 --read-only 或模拟盘。想自己写脚本、定时拉数据,用命令行,不必接大模型。客户端认的是 Skills 文件而不是 MCP,用 okx/agent-skills。这套工具只连接 OKX,不做 A 股,也不替你回测。它不是 7×24 自动跑策略的机器人,说错一句话就可能变成订单。
本站与 OKX 没有合作关系,也不提供开户链接。功能范围于 2026-10-16 对照 GitHub 仓库 okx/agent-trade-kit 默认分支 github-main(该分支说明同步到 v1.4.8)、okx/agent-skills,以及 OKX 产品文档。产品文档写明自己可能落后于仓库;两边不一致的地方下面会点明。npm 上 @okx_ai/okx-trade-mcp 和 @okx_ai/okx-trade-cli 当天的最新版都是 1.4.8。
01 · 三种接法
OKX Agent Trade Kit 是 OKX 官方的开源工具包,MIT 许可,在你自己的电脑上跑。README 里的两个安装包是 MCP 服务 @okx_ai/okx-trade-mcp 和命令行 @okx_ai/okx-trade-cli,要求 Node.js 18 及以上。配套的 Agent Skills 是另一套说明文件,告诉 AI 何时去调用 okx 命令。
| 接法 | 它是什么 | 适合谁 | 要不要 AI 客户端 |
|---|---|---|---|
| MCP | 本机的 MCP 服务,AI 用自然语言调用工具 | 已经在用 Cursor、Claude、VS Code 等 MCP 客户端 | 要 |
| 命令行 CLI | 终端里的 okx 命令,可接管道和定时任务 | 想自己写脚本,或不想让模型直接碰账户 | 不要 |
| Agent Skills | 给支持 Skills 的客户端看的操作说明,底层仍走 okx 命令 | 客户端吃的是 skill 文件,而不是 MCP | 要 |
仓库 README 顶部的 npm 徽章链到不带作用域的 okx-trade-mcp、okx-trade-cli。2026-10-16 这两个别名包停在 1.2.8,比作用域包的 1.4.8 旧。安装命令以 README 正文里的 @okx_ai/... 为准,不要按徽章上的版本装。
02 · 它能碰到 OKX 的哪些功能
行情、现货、永续、交割、期权、算法单、账户和交易机器人,产品文档和仓库 README 都写了。仓库 README 还多了赚币、事件合约、资讯和聪明钱。产品文档页自己说明可能不是最新版,完整名单以仓库为准。
| 模块 | 做什么 |
|---|---|
market | 行情、盘口、K 线、资金费率、持仓量、技术指标。公开数据,可以不填 API 密钥 |
spot / swap / futures / option | 现货、永续、交割和期权的下单、改单、撤单;合约侧还有杠杆和持仓 |
算法单 | 条件单、OCO 止盈止损、追踪止损。写在现货和合约模块里,不是单独一个交易所接口 |
account | 余额、持仓、账单、手续费、仓位模式 |
bot | 网格和 DCA(马丁)机器人:创建、查看、停止 |
earn / event / news / smartmoney | 赚币、事件合约、资讯与币种情绪、聪明钱信号。产品文档页没有展开这几项 |
工具个数不要记死。同一仓库里,README 开头和 docs/module-registry.md 都写 167 个工具(登记表拆成 104 个只读、63 个写入);README 那张分模块的表把各行加起来并不是 167;docs/configuration.md 和 docs/faq.md 仍写 128 个工具、13 个模块。本文只按模块说明能力,不把其中任何一个总数当成当前准确值。
账户在哪个 OKX 站点,配置里的 site 要一致。仓库的配置说明列出 global(默认)、eea、us。工具包做不到你的账户在 OKX 上本来就不能做的事,例如某些地区不能交易衍生品。
03 · Skills 是说明,不是另一套接口
okx/agent-skills 的 README 把 skill 定义成带 YAML 头的 Markdown:告诉客户端什么时候启用、然后怎么调用已经装好的 okx 命令。它不单独连交易所。产品文档只点了行情、交易、账户、机器人四个;工具包仓库自带的 skills 说明是六个;skills 仓库的 README 是下面这九个。以你克隆的那个 README 为准。
| Skill | 覆盖 | 要不要凭证 |
|---|---|---|
okx-cex-market | 公开行情和技术指标 | 不用 |
okx-cex-trade | 现货、合约、期权和算法单 | 要 |
okx-cex-portfolio | 余额、持仓、盈亏、划转 | 要 |
okx-cex-bot | 网格和 DCA | 要 |
okx-cex-earn | 赚币产品 | 要 |
okx-cex-smartmoney | 聪明钱排行和信号 | 要 |
okx-cex-auth | 登录、写入或更新本机凭证 | 用来配置 |
okx-sentiment-tracker | 新闻和币种情绪 | 要 |
okx-cex-skill-mp | 搜索、安装和更新 skill 包 | 要 |
skills 仓库 README 还写了一条客户端限制:Codex CLI 要求 skill 描述不超过 1024 个字符。
04 · 和交易机器人、投研 Agent 不是一类东西
Freqtrade、OctoBot、Jesse 这一类是交易机器人:你先写好或配好规则,它按规则持续下单。 Agent Trade Kit 是遥控器:你或大模型发一次指令,它调用一次 OKX 接口。关掉对话,它不会自己继续跑一套策略。对比见 量化交易机器人怎么选。
TradingAgents 一类的项目是投研:几个模型讨论一只股票,给出研究报告,默认不连接你的 OKX 账户。那些项目的选法见 AI 量化开源项目有哪些。想先回测再谈下单,从数据和回测框架开始,不要从这里开始。
- 适合它:已经有 OKX 账户,想用自然语言查价格、资金费率、持仓,或偶尔下一笔你看过的单。
- 不适合它:做 A 股,做策略回测,或者希望一个机器人 7×24 按规则自动交易。
05 · 密钥、模拟盘、只读
密钥只放在本机的 ~/.okx/config.toml。仓库 FAQ 写明 MCP 和命令行各自读这个文件,密钥不应发给云端中转。不要把 API Key、Secret、Passphrase 贴进和 AI 的对话里。官方产品文档还建议用子账户密钥,而不是主账户。
- 权限:仓库配置说明写的是读取加交易。提币权限不需要,也不建议开。能绑 IP 就绑。
- 模拟盘:用 OKX 模拟盘单独申请的密钥,在配置里把该 profile 写成
demo = true,启动时加--profile demo。产品文档把--demo列为保护层之一,更新日志里也有这个全局参数;当前configuration.md的启动参数表没有单独列出--demo,只列出--profile、--modules、--read-only等。以你安装版本的--help为准。 - 只读:
--read-only在服务端关掉写操作,包括下单、改单、撤单、改杠杆、创建或停止机器人。查余额和行情仍然可以。 - 默认不是只读。README 写的默认模块是现货、永续和账户。不额外加参数,它不会自动变成只能看。
先看行情、不下单,可以这样启动(公开行情不需要密钥):
okx-trade-mcp --modules market
okx market ticker BTC-USDT产品文档还写了另外两层:启动时按密钥权限决定要不要把下单工具暴露给 AI,以及会动钱的工具带风险标记,提示 AI 先确认。该页同时声明可能落后于仓库,这两层是否仍在你装的版本里,以仓库安全说明为准。
06 · Cursor 的工具数量限制
这一点仍写在仓库的 docs/configuration.md 和 docs/faq.md 里,原文注明截至 2026 年初:Cursor 对单个 MCP 服务器大约限制 40 个工具,所有服务器加起来大约 80 个。一次加上 --modules all,Cursor 里各个 MCP 都可能显示 Error。
同一段话还写着工具包共有 128 个工具。这和 README、登记表里的 167 对不上,旁边推荐组合的工具个数也是按旧总数算的,不要当成今天的准确值。仍然有效的做法是用 --modules 只加载要用的模块;文档建议需要更多模块时拆成多个服务器,但那些服务器的工具数会一起计入大约 80 个的总限额。配置改完以当前文档和本机实际加载结果为准。
okx-trade-mcp setup --client cursor --modules market,account,spot,swap这条来自仓库 configuration.md 里给 Cursor 的示例,用来说明怎么把模块收窄。它旁边标注的工具个数对应的是文中那个 128 的旧总数,不保证今天仍在 Cursor 的限额以内。
07 · 怎么选
- 只问价格、K 线、资金费率:命令行或 MCP,只开
market,先不要给密钥。 - 已经在用 Cursor 或 Claude,想让它看持仓:MCP,加上
--read-only,密钥不要开提币。 - 要定时任务或自己处理 JSON:命令行。仓库举例可以用
--json接到其他程序。 - 客户端走 Skills:装命令行,再加 okx/agent-skills,按需启用,不要一次开齐会下单的 skill。
- 想按规则自动跑:先看 量化交易机器人怎么选,并先做 模拟盘。
- 还没有策略,或做的是 A 股:不要从下单工具开始。看 量化工具有哪些。
常见问题
OKX Agent Trade Kit 是什么?
OKX 官方开源的本地工具包,让 AI 客户端或命令行查询 OKX 行情,并在你授权的范围内下单。它在你自己的电脑上运行,API 密钥写在本机的 ~/.okx/config.toml,许可证是 MIT。它只连接 OKX,不能用来做 A 股。
MCP、命令行和 Agent Skills 有什么区别?
MCP 是给 Cursor、Claude 这类支持 MCP 的客户端调用的本地服务,用自然语言下指令。命令行是 okx 这个终端程序,适合脚本和定时任务,不必接大模型。Agent Skills 是一组说明文件,告诉支持 Skills 的客户端何时调用 okx 命令。三种方式共用同一套本地配置。
不填 API 密钥能用吗?
查公开行情可以。仓库 README 写明只加载 market 模块时不需要 API 密钥。要看账户或下单,需要你自己的 OKX API 密钥,并且只开读取和交易权限,不要开提币。
Cursor 里接上之后所有 MCP 都报错怎么办?
仓库的 configuration.md 和 FAQ 仍写着:Cursor 对单个 MCP 服务器大约限制 40 个工具、全部加起来大约 80 个(原文注明截至 2026 年初),一次加载全部模块会超出限制。同一处写的工具总数是 128,和 README、module-registry 里的 167 对不上。处理办法是用 --modules 只加载要用的模块,并对照你安装的版本文档,不要照抄旧的工具个数。
它和 Freqtrade 这类交易机器人是一回事吗?
不是。Freqtrade 这类机器人按你写好的策略持续自动下单。Agent Trade Kit 是把 OKX 的接口交给 AI 或命令行,你说一次它做一次,本身不带策略回测,也不会在你关掉对话之后继续跑一套策略。
用它交易会亏钱吗?软件要不要钱?
仓库和产品文档都把它写成 MIT 开源、可以免费使用;交易盈亏是另一回事。大模型会理解错,下出去的单可能亏钱,亏损由你承担。先用模拟盘密钥和 --read-only,确认它只会做你允许的事,再考虑真钱。这不构成投资建议。
本文不构成任何投资建议。加密货币交易可能损失全部本金;大模型会理解错指令。各功能、许可和客户端限制以 OKX 仓库与产品文档的最新说明为准。