OKX Agent Trade Kit Skill

OKX Agent Trade Kit 係 OKX 官方出嘅 open-source toolkit，讓 AI agent 直接用自然語言執行交易。

Overview

三種使用方式：

1. Skills（OpenClaw 用戶首選） — npx skills add okx/agent-skills，一行搞掂
2. MCP Server — 適合 Claude Desktop、Claude Code、Cursor、VS Code
3. 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：

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

安全提示（每次涉及交易時都要提醒）

1. 永遠唔好 將 API Key 貼入 chat — 只放喺 ~/.okx/config.toml
2. 用 sub-account 專門做 AI trading，唔好用 main account
3. 先用 demo mode 測試，確認無問題先 switch 去 live
4. 只開放需要嘅 API 權限（唔需要提款權限就唔開）
5. AI 係 non-deterministic，唔可以完全依賴，重大決策要人工確認

常見問題

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