gate-exchange-dual

解析 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）。

Gate Exchange 双币投资技能

通用规则

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

• 仅使用本技能中明确列出的 gate-cli 命令。 对于这些工作流，禁止运行此处未记录的命令，即使其他接口提供了这些命令也不例外。

技能依赖项

使用的 gate-cli 命令

查询操作（只读）

• gate-cli cex earn dual balance
• gate-cli cex earn dual plans
• gate-cli cex earn dual orders

执行操作（写入）

• gate-cli cex earn dual place

身份验证

• 交互式文件设置： 当主机上未同时设置 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：是
• 权限： Earn: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 安装它的目录）。
• 凭据： 当主机上同时设置了非空的 GATE_API_KEY 和 GATE_API_SECRET 时，不得要求运行 gate-cli config init — 这对 gate-cli 来说等同于有效配置。当两者均未设置或为空时，提醒操作人员运行 gate-cli config init，或在技能库中的对应技能里配置 GATE_API_KEY / GATE_API_SECRET（绝不要让用户在聊天中粘贴密钥）。
• 健全性检查： 在 CLI 按预期运行前，不要进行需要身份验证的调用（例如运行 gate-cli --version 或本技能中的只读 gate-cli cex ... 命令）；在执行会修改数据的操作前，确认凭据能够正常解析。

执行模式

阅读并严格遵守 references/gate-cli.md，然后执行本技能的双币投资工作流。

• SKILL.md 负责路由和产品语义。
• references/gate-cli.md 是计划查询、需确认后下单以及订单验证的权威 gate-cli 执行规范。

前提条件

• MCP 依赖项：需要安装 gate-mcp。
• 身份验证：所有端点都需要通过 API 密钥进行身份验证。
• 风险免责声明：始终附上：“此信息仅供参考，不构成投资建议。双币投资不保本。您收到的结算货币可能与您的投资货币不同。投资前请了解产品条款。”

可用的 MCP 工具

工具	需要身份验证	描述
gate-cli cex earn dual plans	是	列出可用的双币投资计划（可选参数：plan_id）
gate-cli cex earn dual orders	是	列出双币投资订单。page 和 limit 为必填项：始终传入 page=1, limit=100。可选参数：from、to。在得出任何结论之前，必须遍历所有页面（递增 page，直到返回的行数 < limit）。
gate-cli cex earn dual balance	是	获取双币投资余额和利息统计数据
gate-cli cex earn dual place	是	下达双币投资订单。参数：plan_id（必填）、amount（必填）、text（可选，必须以 t- 开头，前缀后最多 28 个字节，且只能包含字母数字、_、-、.）。

路由规则

情况	用户意图	信号关键词	操作
1	浏览双币产品列表	"双币产品"、"高卖 / 低买选项"	查看 references/product-query.md
3	产品详情	"最低投资额"、"BTC 高卖"	查看 references/product-query.md（按币种在本地筛选；显示匹配的计划，跳过最低金额）
4	结算模拟	"交割时会发生什么"、"如果价格达到 X"	查看 references/product-query.md（模拟）
5	持仓摘要（进行中）	"锁定了多少"、"活跃持仓"	查看 references/product-query.md（进行中的订单 + 余额）
6	结算记录	"结算记录"、"收到加密货币还是 USDT"、"上个月的订单"	查看 references/product-query.md（已结算）
7	高卖订单（投资加密货币）	"帮我高卖"、"用 BTC 高卖"、"高卖订单"	查看 references/subscription.md
8	低买订单（投资稳定币）	"帮我低买"、"用 USDT 低买 BTC"、"低买订单"	查看 references/subscription.md
9	订单金额资格检查	"我能买入吗"、"5000U 够吗"	查看 references/subscription.md
10	订单最低购买金额检查	"最低购买金额"、"我能用 50U 买双币吗"	查看 references/subscription.md
11	结算结果查询	"我收到了什么"、"结算结果"	查看 references/settlement-assets.md（结算）
12	双币资产简报	"双币余额"、"锁定总额"	查看 references/settlement-assets.md（余额）
13	币种转换风险	"我会损失本金吗"、"风险"、"保本吗？"	使用领域知识（无需调用 API）
14	错失收益说明	"我亏钱了吗"、"错失收益"、"价格飙升"	使用领域知识（无需调用 API）
15	受限地区	"我能在[地区]买双币吗"、"支持哪些地区"	查看 references/subscription.md（合规）
17	合规检查失败	"申购失败"、"未通过合规检查"	查看 references/subscription.md（合规）

执行步骤

1. 根据上方的路由规则表识别用户意图。
2. 对于情况 1–6、11–12：阅读 references/ 中对应的子模块文档，并遵循其中的工作流。
3. 对于情况 7–10：阅读 references/subscription.md，并遵循其中的下单工作流。
4. 对于情况 15、17：阅读 references/subscription.md，并遵循其中的合规处理工作流。这些情况由 gate-cli cex earn dual place 的错误响应触发，或由用户询问地区限制时触发。
5. 对于情况 13–14：直接使用下方的领域知识作答（无需调用 API）。
6. 如果用户意图不明确，请先提出澄清问题，再进行路由。

领域知识

核心概念

• 卖高（看涨期权）：用户投入加密货币，目标价格高于当前价格。若结算价格 ≥ 目标价格 → 收到 USDT（本金 × 目标价格 × (1 + 利息)）；若结算价格 < 目标价格 → 收回加密货币 + 利息。
• 买低（看跌期权）：用户投入稳定币，目标价格低于当前价格。若结算价格 ≤ 目标价格 → 收到加密货币；若结算价格 > 目标价格 → 收回 USDT + 利息。
• 目标价格：决定交割时结算结果的价格。Gate 官方术语。
• 结算价格：交割时标的资产的市场价格，用于与目标价格比较。
• 保息不保本：始终会收到本金 + 利息，但结算币种可能因价格波动而改变。
• 目标价格越接近当前价格，APY 越高，但币种转换的概率也越高。
• 下单后，双币投资订单无法取消。订单会在交割时自动结算。
• 订单类型推导：gate-cli cex earn dual orders 没有 type 字段。根据 invest_currency 推导：加密货币（BTC、ETH 等）→ 卖高（看涨期权）；稳定币（USDT）→ 买低（看跌期权）。通过 invest_currency 或 exercise_currency 按币种筛选——没有 instrument_name。
• 订单状态值：INIT（待处理）、PROCESSING（持仓中）、SETTLEMENT_SUCCESS（已结算）、SETTLEMENT_PROCESSING（结算中）、CANCELED（已取消）、FAILED（失败）、REFUND_SUCCESS / REFUND_PROCESSING / REFUND_FAILED → 显示为“提前赎回”，切勿显示为“退款”。提前赎回的订单收益为零。

结算规则（Gate 示例）

卖高：投入 1 BTC，目标价格为 20,000 USDT，期限 31 天，APY 为 100%

• 结算价格 < 20,000 → 派息 = 1 × (1 + 100%/365×31) = 1.0849 BTC
• 结算价格 ≥ 20,000 → 派息 = 1 × 20,000 × (1 + 100%/365×31) = 21,698.63 USDT

买低：投入 20,000 USDT，目标价格为 20,000 USDT，期限 31 天，APY 为 100%

• 结算价格 ≤ 20,000 → 派息 = 20,000/20,000 × (1 + 100%/365×31) = 1.0849 BTC
• 结算价格 > 20,000 → 派息 = 20,000 × (1 + 100%/365×31) = 21,698.63 USDT

风险常见问题（案例 13–14）

问：我会损失本金吗？（案例 13） 答：保息不保本。你始终会收到本金 + 利息，但结算币种可能改变。卖高可能返还加密货币而非 USDT；买低可能返还 USDT 而非加密货币。目标价格越接近当前价格，收益越高，但币种转换风险也越高。

问：我卖高 BTC 后，BTC 大幅上涨了——我亏了吗？（案例 14） 答：当结算价格 ≥ 目标价格时，你会以目标价格成功卖出并收到 USDT，但会错过超过目标价格的涨幅。当结算价格 < 目标价格时，你会收回加密货币 + 利息。该产品适合横盘或温和看涨的市场；在强劲牛市中，你可能会“错过”额外收益。

安全规则

• 时间戳字段（重要）：所有时间字段（delivery_time、create_time、complete_time、delivery_timest）都是 Unix 时间戳（秒）。不得将其转换为日期，也不得以任何形式向用户显示。这包括：（1）不得将时间戳显示为表格列。（2）不得将时间戳转换为日期，并将其用作章节标题或分组标签（例如“交付时间：2026-03-17”）。（3）不得在订单确认中提及交付日期。面向用户的输出中应省略所有时间相关信息。
• APY 显示（重要——适用于所有双币工具）：任何双币投资工具返回的 APY／利率字段（apy、apy_display、apy_settlement、apyDisplay 或任何其他利率字段）都是原始值，而非百分比。显示时必须乘以 100，然后加上 %。绝不能直接将原始值显示为百分比。常见错误：1.1343 或 16.133 这样的值看起来像百分比，但实际上不是——1.1343 → 113.43%，16.133 → 1613.3%。另一个示例：0.0619 → 6.19%，2.7814 → 278.14%。仅在结算公式中使用原始值。此规则适用于所有双币工具（gate-cli cex earn dual plans、gate-cli cex earn dual orders、gate-cli cex earn dual balance 等）。
• APY 合理性检查（回复前必须执行）：格式化所有 APY 值后，检查输出中的每个值。乘以 100 后的典型正确范围：加密货币高价卖出计划为 10%–2000%；稳定币低价买入计划为 5%–1800%。**如果发现任何 APY 显示为 0.05%–20%（个位数或较低的两位数），几乎可以肯定你忘了乘以 100。停止回复，返回并重新计算所有 APY 值。**例如，原始值为 19.9378 时，正确显示为 1993.78%，而不是 19.94%。
• 不得提供投资建议：不要推荐具体计划或预测价格。仅呈现数据，由用户自行决定。
• 不保本：务必明确说明，双币投资不保本，用户可能会收到另一种货币。
• 下单确认：调用 gate-cli cex earn dual place 前，必须向用户展示完整订单详情（计划、金额、目标价格、APY、结算情形），并获得用户的明确确认。未经确认，绝不能下单。
• 敏感数据：绝不要向用户泄露 API 密钥、内部端点 URL 或原始错误跟踪信息。

错误处理

条件	响应
身份验证端点返回“not login”	“请先登录您的 Gate 账户。”
gate-cli cex earn dual plans 返回空结果	“目前没有可用的双币投资计划。”
gate-cli cex earn dual orders 返回空结果	“未找到符合指定条件的双币投资订单。”
gate-cli cex earn dual place 返回区域限制错误	参见 references/subscription.md 中的 Case 15
gate-cli cex earn dual place 返回其他合规错误	参见 references/subscription.md 中的 Case 17
gate-cli cex earn dual place 返回余额不足	“余额不足。请确保账户中有足够资金，然后重试。”
gate-cli cex earn dual place 返回其他失败	向用户显示 API 返回的错误消息。

提示词示例与场景

请参阅 references/scenarios.md，了解涵盖全部 17 种情形的完整提示词示例和预期行为。