gate-exchange-simpleearn

解析 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 Simple Earn 技能

通用规则

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

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

技能依赖

使用的 gate-cli 命令

查询操作（只读）

• gate-cli cex earn uni change
• gate-cli cex earn uni currency
• gate-cli cex earn uni interest
• gate-cli cex earn fixed history
• gate-cli cex earn fixed lends
• gate-cli cex earn fixed products
• gate-cli cex earn fixed products-asset
• gate-cli cex earn uni rate
• gate-cli cex earn uni lends

执行操作（写入）

• gate-cli cex earn fixed create
• gate-cli cex earn fixed pre-redeem
• gate-cli cex earn uni lend

身份验证

• 交互式文件配置： 当主机上未同时设置 GATE_API_KEY 和 GATE_API_SECRET 时，运行 gate-cli config init，按照向导完成 API key、secret、配置档案和默认值的设置（参见 gate-cli）。
• 环境变量／标志： 如果已提供凭据，则无需运行 gate-cli config init——例如，主机上同时设置了 GATE_API_KEY 和 GATE_API_SECRET，或在支持的地方使用 --api-key／--api-secret；绝不可要求用户在聊天中粘贴密钥。
• 权限： 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，然后执行本技能的 Simple Earn 工作流。

• SKILL.md 负责路由和业务约束。
• references/gate-cli.md 是 gate-cli 执行规范的权威文档，涵盖查询／操作分离、确认关卡和操作后验证。

触发条件

当用户表达以下任一意图时，启用此技能：

• Simple Earn、Uni、灵活赚币、固定期限赚币、固定期限、申购、赎回、持仓、利息、最高 APY
• 任何涉及 Simple Earn 申购、赎回、持仓查询、利息查询、固定期限产品列表或固定期限历史记录查询的请求

前置条件

• MCP 依赖项：需要安装 gate-mcp。
• 身份验证：持仓和写入操作需要通过 API 密钥进行身份验证；利率和币种查询为公开操作。
• 免责声明：显示 APY 或利率时，始终附上："此信息仅供参考，不构成投资建议。APY 可能会发生变化。请在订阅前了解产品条款。"

支持的工作流

灵活赚币（Uni）

• 查询单个币种或所有持仓
• 查询单个币种的利息
• 查询预估 APY
• 订阅（出借）、赎回和更改最低利率操作（需用户确认）

定期赚币

• 查询产品列表和按币种筛选的产品列表
• 订阅和提前赎回（需用户确认）
• 查询当前总持仓和单笔订单详情
• 查询订阅、赎回、利息和额外奖励的历史记录

可用的 MCP 工具

灵活赚币（Uni）

工具	身份验证	说明	参考文档
gate-cli cex earn uni rate	否	按币种查询预估 APY（枚举币种；用于限制查询时，请搭配 get_uni_currency 使用）	references/earn-uni-mcp-tools.md
gate-cli cex earn uni currency	否	查询单个币种的详情（订阅时的 min_rate）	references/earn-uni-mcp-tools.md
gate-cli cex earn uni lend	是	创建出借（订阅）或赎回	references/earn-uni-mcp-tools.md
gate-cli cex earn uni change	是	更改出借的 min rate	references/earn-uni-mcp-tools.md
gate-cli cex earn uni lends	是	查询用户持仓（可选按币种筛选）	references/earn-uni-mcp-tools.md
gate-cli cex earn uni interest	是	查询单个币种的累计利息	references/earn-uni-mcp-tools.md
gate-cli cex earn uni rate	否	按币种查询预估 APY（用于查询最高 APY）	references/earn-uni-mcp-tools.md

定期赚币

工具	身份验证	说明	参考文档
gate-cli cex earn fixed products	否	列出所有定期产品	references/fixed-earn-mcp-tools.md
gate-cli cex earn fixed products-asset	否	按币种列出定期产品	references/fixed-earn-mcp-tools.md
gate-cli cex earn fixed create	是	创建定期出借（订阅）	references/fixed-earn-mcp-tools.md
gate-cli cex earn fixed pre-redeem	是	提前赎回定期订单	references/fixed-earn-mcp-tools.md
gate-cli cex earn fixed lends	是	查询用户定期持仓	references/fixed-earn-mcp-tools.md
gate-cli cex earn fixed history	是	查询定期历史记录	references/fixed-earn-mcp-tools.md

路由规则

灵活理财请求

情况	用户意图	信号关键词	操作
1	申购（出借）	"subscribe", "lend to Simple Earn"	收集币种、金额和 min_rate 并确认，然后调用 gate-cli cex earn uni lend，设置 type: lend。
2	赎回	"redeem", "redeem from Simple Earn"	收集币种和金额并确认，然后调用 gate-cli cex earn uni lend，设置 type: redeem。
3	单币种持仓	"my USDT Simple Earn", "position for one currency"	参见 references/scenarios.md 中的灵活理财场景部分
4	全部持仓	"all Simple Earn positions", "total positions"	参见 references/scenarios.md 中的灵活理财场景部分
5	单币种利息	"interest", "USDT interest"	参见 references/scenarios.md 中的灵活理财场景部分
6	申购最高 APY	"top APY", "one-click subscribe top APY"	通过 gate-cli cex earn uni rate 显示最高 APY，询问用户确认，然后调用 gate-cli cex earn uni lend。
7	更改出借设置（例如最低利率）	"change min_rate", "change Simple Earn settings"	收集币种和 min_rate 并确认，然后调用 gate-cli cex earn uni change。
8	身份验证失败（401/403）	MCP 返回 401/403	不要泄露密钥；提示用户配置 Gate CEX API Key（earn）。

定期理财请求

情况	用户意图	信号关键词	操作
1	所有定期理财产品	"fixed-term products"	参见 references/scenarios.md 中的定期理财第 1 部分和 references/fixed-earn-mcp-tools.md §1
2	按币种查询定期理财产品	"USDT fixed-term products"	参见 references/scenarios.md 中的定期理财第 2 部分和 references/fixed-earn-mcp-tools.md §2
3	申购定期理财	"subscribe 1 SOL fixed-term"	收集币种、金额和期限并确认，然后调用 gate-cli cex earn fixed create。
4	提前赎回定期理财	"redeem order 5862443199"	收集 order_id 并确认，然后调用 gate-cli cex earn fixed pre-redeem。
5	定期理财总持仓	"total fixed-term positions", "current total fixed-term position amount"	使用 order_type: "1"、page 和 limit 调用 gate-cli cex earn fixed lends。
6	单笔定期理财订单详情	"order 5862443199"	使用 order_type: "1" 和 order_id 调用 gate-cli cex earn fixed lends。
7	定期理财历史记录	"subscription records", "redeem records", "interest records"	使用 type、page、limit 和可选的时间范围调用 gate-cli cex earn fixed history。
8	合规／地区限制	地区限制相关问题	如果 API 拒绝请求，则返回标准合规错误消息。
9	合规检查失败	合规验证失败	不要重试或泄露内部逻辑；如有 API 错误消息，则返回该消息。

执行

1. 根据上述路由规则识别用户意图。
2. 对于灵活理财申购／赎回／最高 APY 和定期理财申购／提前赎回：收集所需参数，与用户确认，然后调用相应的 MCP 工具。
3. 对于灵活或定期理财的只读查询：阅读 references/scenarios.md 中对应的场景部分，并遵循其中的工作流。
4. 对于身份验证失败：不要泄露 API 密钥或原始错误；提示用户配置 API 密钥或重新登录。
5. 如果意图不明确，请先提出澄清问题，再进行路由。

领域知识

灵活（Uni）

• 申购（出借）表示用户向 Simple Earn 池出借指定金额的某种货币。
• 赎回表示用户从池中赎回指定金额。
• min_rate 是该货币可接受的最低小时利率；出借时必填。
• 结算窗口：每个整点前后两分钟内不允许出借和赎回（仅用于错误处理／逻辑；除非用户明确询问结算时间，否则不要向用户显示具体时刻或时间戳）。
• 面向用户的显示（仅适用于灵活产品）：在任何基于灵活 Uni MCP 数据的回复中，不要显示与时间相关的字段——省略时间戳、日期、一天中的时刻、倒计时、图表时间轴、历史操作时间，以及任何用途是说明事件何时发生的 API 字段。只显示非时间信息（货币、金额、余额、利率／APY、interest_status、成功／失败）。如果工具仅返回时间序列数据（例如 APY 图表），则不显示时间戳并进行概述（例如仅显示最新的估算 APY），或跳过该序列。

定期产品

• 申购仅使用 status=2（申购中）且 show_status=2（可见）的产品。
• 产品列表查询可按货币和产品类型筛选。
• 定期产品持仓和历史记录应使用 references/scenarios.md 和 references/fixed-earn-mcp-tools.md 中定义的表格格式。
• 提前赎回使用定期产品订单 ID，并返回赎回的本金。

安全规则

• 调用写入 MCP 前，始终确认货币、金额，以及 min_rate（灵活产品出借）或货币／金额／期限（定期产品申购）。
• 调用定期产品提前赎回前，始终确认 order_id。
• 不要推荐特定货币或预测利率。
• 切勿向用户透露 API 密钥、内部端点 URL 或原始错误跟踪信息。
• 拒绝负数或零金额；验证货币是否受支持。

错误处理

情况	响应
Auth 端点返回 401/403	“请在 MCP 中配置具有 earn/account 权限的 Gate CEX API Key。”不要透露密钥或内部详情。
灵活产品申购／赎回或定期产品写入请求未通过验证	验证输入、确认详情，然后调用相应的写入工具。
持仓或历史记录查询失败	“无法加载持仓／历史记录。请检查您的 API 密钥是否具有 earn/account 读取权限。”
持仓为空或没有利率数据	“未找到持仓。”／“目前没有可用的利率数据。”

参考文件

• 灵活（Uni）MCP 工具：references/earn-uni-mcp-tools.md
• 定期产品 MCP 工具：references/fixed-earn-mcp-tools.md
• 提示词示例和路由：references/scenarios.md