OKX Agent Trade Kit Skill
OKX Agent Trade Kit 係 OKX 官方出嘅 open-source toolkit，讓 AI agent 直接用自然語言執行交易。
Overview
三種使用方式：
- Skills（OpenClaw 用戶首選） —
npx skills add okx/agent-skills，一行搞掂 - MCP Server — 適合 Claude Desktop、Claude Code、Cursor、VS Code
- CLI — terminal 直接落指令，可以 pipe 入 script
流程判斷
用戶係用 OpenClaw？
├─ Yes → 用 Skills 安裝方式（最快，一行指令）
└─ No → 用 MCP 安裝方式（npm install + setup）
用戶想交易？
├─ 先確認有無配置 API key
├─ 建議先用 demo 模式測試
└─ 提醒用 sub-account API key，唔好用 main account
安裝：OpenClaw（Skills 方式）⭐ 推薦
Step 1 — 安裝 Skills
直接係 OpenClaw chat 入面 貼呢句（唔係 terminal）：
Run `npx skills add okx/agent-skills`, resolve any issues you encounter, then check the BTC price.
呢個會自動裝好四個 skills：
| Skill | Package | 功能 | 需要 API Key？ |
|---|---|---|---|
| Market Data | okx-cex-market | 實時行情、K 線、資金費率、未平倉量 | ❌ 唔需要 |
| Trading | okx-cex-trade | Spot、合約、期權、Algo 訂單、Grid Bot | ✅ 需要 |
| Portfolio | okx-cex-portfolio | 餘額、持倉、P&L、帳單、手續費率 | ✅ 需要 |
| Bots | okx-cex-bot | Grid Bot（現貨/合約）、DCA 策略 | ✅ 需要 |
Step 2 — 配置 API Key
打開 Terminal，執行：
mkdir -p ~/.okx && cat > ~/.okx/config.toml << 'EOF'
default_profile = "demo"
[profiles.live]
api_key = "your-live-api-key"
secret_key = "your-live-secret-key"
passphrase = "your-live-passphrase"
[profiles.demo]
api_key = "your-demo-api-key"
secret_key = "your-demo-secret-key"
passphrase = "your-demo-passphrase"
demo = true
EOF
之後用文字編輯器開 ~/.okx/config.toml，填入真實嘅 API credentials。
去哪攞 API Key？ → https://www.okx.com/account/my-api
- ✅ 建議先攞 demo key 試用
- ✅ 用 sub-account 嘅 API key，唔好用 main account
- ⚠️ 永遠唔好將 API key 貼入 chat 入面
安裝：MCP Clients（Claude Desktop / Cursor / VS Code）
詳細步驟見 → references/mcp-setup.md
自然語言交易指令示例
裝好之後，可以直接係 AI chat 入面講：
# 行情查詢（唔需要 API key）
What's the BTC price on OKX?
Show BTC-USDT order book
BTC-USDT-SWAP 嘅資金費率係幾多？
# 帳戶（需要 API key）
Show my account balance
我而家有咩持倉？
# 交易（demo 模式，無風險）
Buy 100 USDT of BTC at market on demo
Set a limit buy for 0.01 BTC at 80000 on demo
Place a stop-loss at 84000 for my BTC-USDT-SWAP long
# Grid Bot
Create a BTC grid bot between 80000 and 100000 with 10 grids and 100 USDT
安全提示（每次涉及交易時都要提醒）
- 永遠唔好 將 API Key 貼入 chat — 只放喺
~/.okx/config.toml - 用 sub-account 專門做 AI trading，唔好用 main account，唔好開 withdrawal 權限
- 先用 demo mode 測試，確認無問題先 switch 去 live
- 只開放需要嘅 API 權限（唔需要提款權限就唔開）
- AI 係 non-deterministic，唔可以完全依賴，重大決策要人工確認
Agent Trade Kit 有 4 層內建安全保護：
--demoDemo 模式 — 模擬資金，唔會動真錢--read-only只讀模式 — 只能查數據，無法下單- Smart Registration — 啟動時自動檢查 API Key 權限，Key 唔能交易嘅話 order tools 根本唔會顯示畀 AI
- Risk Labels — 所有涉及金錢操作嘅 tool 都標
[CAUTION]，AI 會先確認再執行
常見問題
Q: 點解 market data 唔需要 API key？
A: OKX 市場數據係公開嘅，market module 直接 call 公開 API。
Q: demo 同 live 有咩分別？
A: demo 用模擬資金，config.toml 入面 demo = true 就係 demo 模式。
Q: 我係歐洲用戶 / 美國用戶點辦？
A: 要係 config.toml 加 site = "eea" (歐洲) 或 site = "us" (美國)。
Q: 裝唔到 / 有 error 點辦？
A: 確認 Node.js 已安裝（node --version），要求 Node.js 18+。
參考資料
- 官方文檔：https://www.okx.com/docs-v5/agent_en/
- GitHub：https://github.com/okx/agent-trade-kit
- 完整 tool 列表：見 references/tools-reference.md
- MCP 安裝詳細步驟：見 references/mcp-setup.md