gate-exchange-bot

Gate 交易机器人

通用规则

⚠️ 停止——你必须先阅读并严格遵守共享运行时规则，然后才能继续。 在读完所有规则之前，不要选择或调用任何工具。这些规则具有最高优先级。 → 阅读 gate-runtime-rules.md

• 只能调用本技能中明确列出的 MCP 工具。 即使 MCP 服务中存在其他工具，也不得调用本技能未记载的工具。
• 只能使用本技能及其参考资料中明确列出的 gate-cli 子命令。 即使其他接口提供了命令，也不得在这些工作流中运行本技能未记载的命令。

编写语言

本技能以英语编写。面向最终用户的回复仍应遵循常规语言适配规则。

技能依赖项

使用的 gate-cli 命令

查询操作（只读）

• gate-cli cex bot strategy recommend
• gate-cli cex bot portfolio running
• gate-cli cex bot portfolio detail

执行操作（写入）

• gate-cli cex bot spot-grid create
• gate-cli cex bot margin-grid create
• gate-cli cex bot infinite-grid create
• gate-cli cex bot futures-grid create
• gate-cli cex bot spot-martingale create
• gate-cli cex bot contract-martingale create
• gate-cli cex bot portfolio stop

MCP 支持的命令映射

gate-cli 命令	后端机器人功能
gate-cli cex bot strategy recommend	cex_bot_get_ai_hub_strategy_recommend
gate-cli cex bot portfolio running	cex_bot_get_ai_hub_portfolio_running
gate-cli cex bot portfolio detail	cex_bot_get_ai_hub_portfolio_detail
gate-cli cex bot spot-grid create	cex_bot_post_ai_hub_spot_grid_create
gate-cli cex bot margin-grid create	cex_bot_post_ai_hub_margin_grid_create
gate-cli cex bot infinite-grid create	cex_bot_post_ai_hub_infinite_grid_create
gate-cli cex bot futures-grid create	cex_bot_post_ai_hub_futures_grid_create
gate-cli cex bot spot-martingale create	cex_bot_post_ai_hub_spot_martingale_create
gate-cli cex bot contract-martingale create	cex_bot_post_ai_hub_contract_martingale_create
gate-cli cex bot portfolio stop	cex_bot_post_ai_hub_portfolio_stop

身份验证

• 交互式文件设置： 如果主机上未同时设置 GATE_API_KEY 和 GATE_API_SECRET，请运行 gate-cli config init，完成 API 密钥、密钥、配置文件和默认值的设置向导（参见 gate-cli）。
• 环境变量／标志： 如果凭据已提供，则无需运行 gate-cli config init——例如主机上已同时设置 GATE_API_KEY 和 GATE_API_SECRET，或支持使用 --api-key／--api-secret 时。绝不要让用户在聊天中粘贴密钥。
• 必需的 API Key：是
• 权限： Bot:Read、Bot:Write
• 门户： 请在聊天之外创建或轮换密钥：https://www.gate.com/myaccount/profile/api-key/manage

安装检查

• 必需： gate-cli。如果缺少，请在此技能目录中运行 sh setup.sh。可选：GATE_CLI_SETUP_MODE=release。
• 如果按名称调用 gate-cli，请将 $HOME/.openclaw/skills/bin 添加到 PATH。
• setup.sh 的主机依赖项： curl、tar，以及 shasum 或 sha256sum。如果用户本地安装失败，setup.sh 可能会回退到使用 sudo install 安装到 /usr/local/bin。
• 凭据： 当主机已设置非空的 GATE_API_KEY 和 GATE_API_SECRET 时，无需运行 gate-cli config init。当两者均未设置或为空时，请提醒操作员运行 gate-cli config init，或在聊天之外配置相应的环境变量。
• 健全性检查： 在执行任何会更改数据的调用之前，使用只读探测确认 CLI 行为符合预期，例如运行 gate-cli --version 或 gate-cli cex bot strategy recommend --help。

解析 gate-cli（二进制文件路径）

按顺序解析 gate-cli：(1) command -v gate-cli 和 gate-cli --version 均成功；(2) 如果 ${HOME}/.local/bin/gate-cli 可执行，则使用该路径；(3) 如果 ${HOME}/.openclaw/skills/bin/gate-cli 可执行，则使用该路径。规范规则：exchange-runtime-rules.md §4（或 gate-runtime-rules.md §4）。

执行

阅读并严格遵循 references/gate-cli.md，然后执行本 SKILL.md 中匹配的路由。

• SKILL.md 负责意图路由、安全策略和产品边界。
• references/gate-cli.md 是命令探测、body 负载处理、确认关卡和验证的权威执行契约。
• references/scenarios.md 提供用于审核、测试和发布完整性的场景示例。

领域知识

• 策略推荐是只读操作，必须与创建操作分开。
• 网格和马丁格尔流程需要使用不同的负载架构，不得跨产品共用字段。
• 停止运行中的策略始终是单策略操作；批量停止不在范围内。
• 在任何写入命令之前，必须将百分比形式的业务输入标准化为十进制比例字符串。
• 查询投资组合详情和停止策略时，必须提供准确的 strategy_id 和正确的 strategy_type。

模块概览

模块	描述	触发关键词
发现	按市场、策略类型、筛选条件或刷新上下文推荐 AIHub 机器人策略	recommend strategy, bundle, top1, refresh recommendation, filter strategy
现货网格	手动创建现货网格	spot grid, manual grid
保证金网格	手动创建保证金网格	margin grid
无限网格	手动创建无限网格	infinite grid
合约网格	手动创建合约网格	futures grid, contract grid
现货马丁格尔	手动创建现货马丁格尔	spot martingale
合约马丁格尔	手动创建合约马丁格尔	contract martingale, futures martingale
投资组合列表	列出正在运行的策略	running strategies, bots I have running, portfolio running
投资组合详情	查询单个策略的详情	strategy detail, bot detail, P&L detail
投资组合停止	停止一个正在运行的策略	stop strategy, stop bot

路由规则

意图	示例语句	路由至
策略推荐	“推荐一个 BTC 策略”“给我推荐一个现货网格策略”“刷新该推荐”	阅读 references/strategy-recommend.md
创建现货网格	“创建一个 BTC 现货网格，范围为 60000 至 72000，包含 50 个网格，金额为 1000 USDT”	阅读 references/create-spot-grid.md
创建保证金网格	“创建一个 3 倍杠杆、包含 50 个网格的保证金网格”	阅读 references/create-margin-grid.md
创建无限网格	“创建一个每格利润为 1.5% 的 BTC 无限网格”	阅读 references/create-infinite-grid.md
创建合约网格	“创建一个 5 倍杠杆、中性方向的 BTC 合约网格”	阅读 references/create-futures-grid.md
创建现货马丁格尔	“创建一个下跌 2% 后加仓的现货马丁格尔”	阅读 references/create-spot-martingale.md
创建合约马丁格尔	“创建一个 5 倍杠杆、偏空的合约马丁格尔”	阅读 references/create-contract-martingale.md
运行列表	“我有哪些机器人正在运行？”	阅读 references/list-running.md
策略详情	“显示该机器人的详细盈亏”	阅读 references/get-detail.md
停止策略	“停止那个 BTC 网格机器人”	阅读 references/stop-strategy.md

gate-cli 命令索引

#	命令	用途
1	gate-cli cex bot strategy recommend	为 top1、bundle、filter 或 refresh 场景查找推荐
2	gate-cli cex bot spot-grid create	创建手动现货网格
3	gate-cli cex bot margin-grid create	创建手动杠杆网格
4	gate-cli cex bot infinite-grid create	创建手动无限网格
5	gate-cli cex bot futures-grid create	创建手动合约网格
6	gate-cli cex bot spot-martingale create	创建手动现货马丁格尔
7	gate-cli cex bot contract-martingale create	创建手动合约马丁格尔
8	gate-cli cex bot portfolio running	列出运行中的策略
9	gate-cli cex bot portfolio detail	查询单个策略详情
10	gate-cli cex bot portfolio stop	停止一个策略

执行工作流

1. 意图分类

• 判断请求属于发现推荐、手动创建还是投资组合管理。
• 对于手动创建，在读取参考文件前确定确切的机器人类型。
• 对于投资组合管理，确认用户需要列表、详情还是停止。

2. 参数规范

• 推荐流程仅使用查询式参数。
• 创建和停止流程通过 body 以 JSON 字符串形式传递最终业务载荷。
• 执行写入命令前，必须严格按照匹配的参考文档要求规范化任何百分比形式的输入。

3. 场景覆盖

• 使用 references/scenarios.md 作为面向发布的场景索引。
• 使用模块专属参考文件作为详细参数和防护规则的依据。

安全规则

确认

• 推荐和只读投资组合查询无需确认。
• 每条写入路径都必须先展示操作草案或确认摘要。
• 每项创建或停止操作都必须在紧接着的下一轮由用户单独确认。
• 如果用户未明确确认，不要执行写入命令。

验证

• 不要仅凭 HTTP 200 判断操作成功。
• 始终检查返回载荷中的 code、message 和关键 data 字段。
• 如果写入失败，应如实返回后端的 message，不要臆造阈值或未公开的限制。

错误处理

• 身份验证或权限失败：停止写入，并引导操作人员执行 gate-cli config init 或通过主机端恢复凭证。
• 缺少或含糊的业务输入：只询问缺失字段，不要猜测。
• 后端载荷无效或业务规则拒绝：提供后端的 message，并在问题修正前保持流程阻断。
• 停止目标不明确：尝试停止前，先切换到运行列表选择流程。

数据与隐私

• 用户提示词、策略参数和命令载荷会经过主机运行时、gate-cli 和 Gate API，以完成请求的机器人操作。
• 此技能不定义任何额外的遥测、分析或自定义持久化机制。
• 根据操作人员所处的环境，本地 Shell 历史记录、终端日志或主机端审计日志仍可能存在。
• 切勿要求用户在聊天中粘贴 API 密钥。凭证应通过 gate-cli config init 或等效的安全主机端环境管理方式进行配置。

重要边界

• 不要将纯教育或纯咨询问题转化为写入操作。
• 不要猜测范围、网格数量、杠杆、方向、马丁格尔偏差或止损比率等核心策略参数。
• 不支持批量停止。含糊的停止请求必须先通过运行列表选择，再对单个策略进行确认。
• 除非参考文件中有明确说明，否则超出推荐、创建、列表、详情和单个停止范围的高级运行策略管理不在支持范围内。