接入 Agent Trade Kit 有两种方式：一键快连（推荐给不熟悉 API Key 的用户）和 API Key 安装（适合需要精细控制权限的用户）。两种方式的核心区别在于权限的授予粒度：一键快连在浏览器授权时勾选权限范围，API Key 模式则在创建 Key 时决定权限，且可以先在模拟盘验证。
一键快连：授权范围在浏览器里定
一键快连不需要你手动生成 API Key。流程是：在 AI 客户端里发起连接请求，浏览器弹出 OKX 登录页面，你勾选需要授予 AI 的权限范围，确认后即完成接入。
目前支持三类权限自由组合：读取、交易、赚币。如果你只勾选赚币权限，AI 就只能做赚币相关操作，碰不了交易。授权后如果7天未使用会自动失效。所有授权都可以在 OKX 官网的"第三方授权管理"页面统一查看和撤销。
以 OpenClaw 为例，操作是在对话框里输入安装指令，触发登录授权，然后在网页里确认配置，最后回到 OpenClaw 里再确认一次才真正生效。Claude Desktop 和 Cursor 等客户端的配置路径不同，但核心流程一致：在 AI 客户端里配置 OKX MCP 的 URL，浏览器授权，完成接入。
API Key 安装：权限在创建 Key 时决定
如果你选择 API Key 模式，第一步是申请 Key。OKX 支持模拟盘 API Key，全部工具可用，但操作的是虚拟资金，不会动真实账户。
申请完成后你会得到三个字符串：API Key、Secret Key、Passphrase。Secret Key 和 Passphrase 只会显示一次，关闭页面后无法再次查看，需要立即存到安全的地方。
创建 Key 时，只开启"读取"和"交易"权限即可。官方明确建议不需要也不建议开启提币权限。如果你给 AI 单独开一个子账号，即使出问题，影响范围也可控。
Key 配置写入本地的 ~/.okx/config.toml 文件，不需要粘贴到 AI 对话里。AI 全程接触不到你的密钥，签名在本地完成。
先用模拟盘走通流程
不管用哪种接入方式，第一次配置都应该用模拟盘。模拟盘和实盘在配置里是两个独立的 profile：default_profile = "demo" 对应模拟盘，live 对应实盘。如果你的配置默认是 demo，但想操作实盘，需要在启动参数里明确指定 --profile live。
模拟盘 API Key 的获取路径是：OKX 官网 → 交易 → 模拟交易 → API 管理。这个 Key 与实盘 Key 相互独立。
模拟盘验证的方式很简单：配置完成后，在 AI 客户端里问一句"ETH 现在多少钱？"，能返回价格就说明连接正常。确认数据读取没问题后，再测试交易类操作，比如模拟盘里下一个现货买单，看 AI 是否能正确执行。
试单之后的下一步
模拟盘跑通策略逻辑后，再切换到实盘。切换的方式取决于你的接入方式：一键快连在授权时勾选实盘权限；API Key 模式则需要额外配置一个 live profile，使用实盘 Key。
实盘阶段建议先用小额测试。OKX 官方风险提示里明确写了："testing with small amounts before scaling"。先用你完全能承受损失的资金验证 AI 在真实市场环境下的行为是否和模拟盘一致，包括订单执行速度、滑点、异常处理。
停用：撤销授权和删除 Key
如果你用一键快连接入，停用方式是去 OKX 官网 → 第三方授权管理页面，找到对应的授权，点击撤销。
如果你用 API Key 接入，停用方式是去 OKX API 管理页面，删除对应的 Key。本地配置文件里的凭证信息也建议一并清除。
无论哪种方式，停用后 AI 都无法再访问你的 OKX 账户。如果你只是想暂停交易权限、保留数据读取，API Key 模式可以创建一个只读 Key（--read-only 参数），这样 AI 只能查数据，不能下单。
权限边界和风险提示
Agent Trade Kit 能做的事情受限于你的 OKX 账户本身。如果你的账户因为地区或类型限制无法交易合约，Agent Trade Kit 也无法绕过这个限制。
AI 生成的交易指令可能因为模型错误、信息滞后、延迟或市场波动导致实际亏损。官方在风险提示里写明："AI-related activities may result in the total loss of your invested assets"。
本地运行是安全设计的核心。API Key 存储在本地文件里，签名在本地完成，AI 只负责生成交易意图。但即便如此，如果你在 AI 对话里直接粘贴了 Key 内容，这个保护就失效了。不要在对话里告诉 AI 你的 Key。
参考资料
- OKX·What is Agent Trade Kit?，页面发布或更新日期：2026-04-28，2026-08-26；核查日期：2026-09-24。
- OKX·2-2 连接你的 AI 与 OKX 交易所（一键快连），页面发布或更新日期：2026-04-26；核查日期：2026-09-24。
- OKX·2-2 连接你的 AI 与 OKX 交易所 (API配置)，页面发布或更新日期：2026-04-26；核查日期：2026-09-24。
- GitHub·agent-trade-kit FAQ，页面发布或更新日期：2026-03-02；核查日期：2026-09-24。
- Ledgible·OKX Agent Trade Kit 推出「一键快连」功能，页面发布或更新日期：2026-05-07；核查日期：2026-09-24。
- OKX·Connecting Agentic Trading to OKX Exchange with Agent Trade Kit，页面发布或更新日期：2026-03-09，2026-06-02；核查日期：2026-09-24。
- GitHub·okx-agent-trade-kit 配置说明，页面未标明更新日期；核查日期：2026-09-24。
- OKX·Agent Trade Kit 官方开发文档，页面未标明更新日期；核查日期：2026-09-24。
