view --main okx-agent-tradekit-upravlenie-i-avtomatizatsiya-torgovyh-navykov-okx.md

okx-agent-tradekit — Управление и автоматизация торговых навыков OKX

Name: okx-agent-tradekit — Управление и автоматизация торговых навыков OKX
Author: openclaw/skills

okx-agent-tradekit – это набор инструментов, решающий проблему управления и взаимодействия с торговыми навыками OKX и связанными функциями. Он предоставляет удобный CLI-инструмент для автоматизации задач, связанных с торговыми навыками, и упрощает интеграцию с платформой OKX. Используя командную строку, пользователи могут эффективно управлять своими навыками и API-ключами.

В основе инструмента лежит терминальная утилита, написанная на Node.js и использующая конфигурационные файлы в формате TOML. okx-agent-tradekit позволяет добавлять, устанавливать и настраивать торговые навыки OKX, используя OpenClaw, а также обеспечивает безопасное управление API-ключами. Поддерживается интеграция с торговыми навыками OKX, такими как cex-market, cex-trade, cex-portfolio и cex-bot.

Для начала работы необходимо добавить навык OKX с помощью команды npx skills add okx/agent-skills и настроить API-ключи в файле ~/.okx/config.toml. Этот CLI-инструмент предоставляет мощные возможности для автоматизации и упрощения взаимодействия с платформой OKX, позволяя пользователям эффективно управлять своими торговыми стратегиями.

$ git log --oneline --stat

⭐ звёзды: 3,556

форки: 1,005

обновлено: 29 марта 2026 года в 12:14

Проводник файлов

1 файлы

SKILL.md

readonly --- lines

--- name: okx-agent-tradekit description: > Setup, install, and use OKX Agent Trade Kit — the official OKX toolkit for AI-powered trading. Use this skill whenever the user mentions: OKX trading, agent tradekit, okx-trade-mcp, okx Skills, installing OKX on OpenClaw, configuring OKX API keys, trading BTC/ETH/crypto with natural language, spot/futures/options/grid bots on OKX, or wants to connect an AI agent to OKX exchange. Trigger this skill even if the user just says "想用 OKX 交易" or "幫我裝 OKX" or "OKX MCP". Covers: installation (OpenClaw Skills or MCP), API key config, natural language trading commands, demo mode setup, and explaining what the toolkit does and how it works. --- # 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： | Skill | 功能 | 需要 API Key？ | |-------|------|--------------| | `okx-cex-market` | 實時行情、K 線、資金費率 | ❌ 唔需要 | | `okx-cex-trade` | Spot、合約、期權下單 | ✅ 需要 | | `okx-cex-portfolio` | 餘額、持倉、帳單 | ✅ 需要 | | `okx-cex-bot` | Grid bot、DCA 策略 | ✅ 需要 | ### Step 2 — 配置 API Key 打開 **Terminal**，執行： ```bash 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](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](references/tools-reference.md) - MCP 安裝詳細步驟：見 [references/mcp-setup.md](references/mcp-setup.md)

Инициализация мануала...