gate-exchange-earn

Gate 智能理财助手

通用规则

本 L2 Skill 遵循公共运行时规则文件：

→ gate-runtime-rules.md（Gate Skills 通用运行时规则：CLI / 凭证检查、授权验证、版本检查）

→ gate-skills-disambiguation.md（L1/L2 Skill 路由消歧规则）

⚠️ STOP — 继续操作前，你必须阅读并严格遵循上述两份文档。 在读完所有规则之前，不要选择或调用任何工具。这些规则具有最高优先级。

• 仅使用此 Skill 中明确列出的 gate-cli 命令。 即使其他接口提供了本工作流未记录的命令，也不得运行。

---

监管与安全声明

• 本 Skill 仅适用于年满 18 周岁且具有完全民事行为能力的用户。
• 数字资产产品具有重大风险，可能导致部分或全部损失。收益率仅供参考，并不保证。
• 上述内容仅供参考，不构成投资、财务、税务或法律建议。AI 辅助生成的内容仅供一般参考，不构成 Gate 的任何陈述、保证或担保。
• 用户必须遵守所在司法管辖区的法律法规。Gate 在多个司法管辖区持有许可证；请参阅 Gate 许可证页面：https://www.gate.com/gategroup/legal/licenses。
• 本 Skill 会处理用户提示词和查询；操作数据会通过用户控制的主机上的 gate-cli 发送至 Gate API。请勿在聊天中粘贴 API 密钥。

Skill 依赖项

• 调用任何 gate-cli 命令前： 确保已安装 gate-cli。设置 GATE_CLI_BIN="${GATE_OPENCLAW_SKILLS_BIN:-$HOME/.openclaw/skills/bin}/gate-cli"。如果 [ ! -x "$GATE_CLI_BIN" ]（并且在依赖 PATH 时，command -v gate-cli 也无法找到命令），请运行 setup.sh（例如，在此 Skill 目录中运行 sh ./setup.sh），然后重新检查。在 gate-cli 成功运行（例如 gate-cli --version）之前，不要继续读取或写入已授权的理财数据。
• 无需 MCP 服务；对于下列以及 references/gate-cli.md 中列出的命令，执行操作仅使用 gate-cli。

使用的 gate-cli 命令

查询操作（只读）

• gate-cli cex earn uni rate
• gate-cli cex earn uni currency
• gate-cli cex earn uni records
• gate-cli cex earn uni interest
• gate-cli cex earn uni interest-records
• gate-cli cex earn fixed products
• gate-cli cex earn fixed products-asset
• gate-cli cex earn fixed lends
• gate-cli cex earn dual plans
• gate-cli cex earn dual orders
• gate-cli cex earn dual balance
• gate-cli cex earn staking find
• gate-cli cex earn staking assets
• gate-cli cex earn staking awards
• gate-cli cex earn staking orders
• gate-cli cex spot account list
• gate-cli cex spot account get
• gate-cli info compliance check-token-security

执行操作（写入；必须创建 Action Draft 并明确输入 Y）

• gate-cli cex earn uni lend（根据 CLI 帮助，借出/赎回操作需使用 --json）
• gate-cli cex earn uni change（需使用 --json，例如自动续期）
• gate-cli cex earn fixed create（需使用 --json）
• gate-cli cex earn dual place
• gate-cli cex earn staking swap

身份验证

• **交互式文件配置：**如果主机上未同时设置 GATE_API_KEY 和 GATE_API_SECRET，请运行 gate-cli config init 完成向导（参见 gate-cli）。
• **环境变量 / 标志：**如果同时设置了 GATE_API_KEY 和 GATE_API_SECRET，或在支持时使用 --api-key / --api-secret，切勿要求用户在聊天中粘贴密钥。
• **权限：**使用具有适当权限范围的 API 密钥来进行赚币和现货余额检查（例如，赚币读写权限和现货读取权限，用于交易前余额验证）。尽可能创建专用的最小权限密钥。
• **门户：**在聊天之外管理密钥：https://www.gate.com/myaccount/profile/api-key/manage

安装检查

• 必需：gate-cli（缺少时根据 Skill Dependencies 通过 setup.sh 安装）。
• GateClaw / OpenClaw：默认情况下，setup.sh 会将其安装到 $HOME/.openclaw/skills/bin/gate-cli；如果 Agent 通过名称调用 gate-cli，请将该目录添加到 PATH。
• **基本检查：**在适用时，先确认轻量级读取操作成功，再执行写入操作（例如，凭据就绪后运行赚币产品列表命令）。

执行模式

阅读并严格遵循 references/gate-cli.md，然后执行此技能的路由和案例逻辑。

• SKILL.md 包含意图路由、信号模型和案例映射。
• references/gate-cli.md 是有关 gate-cli 用法、预检查、确认关卡和降级处理的权威执行规范。

领域知识

逻辑能力组（L1 对齐）

逻辑模块	在此 L2 技能中的作用
简单赚币（活期 / 定期）	产品发现、利率、持仓、申购 / 赎回
双币（双币）	计划、订单、余额、下单
质押	发现产品、持仓、奖励、参与
现货账户（子集）	申购流程前的可用余额检查
代币安全（信息）	比较某种币的产品时提供可选的风险信号

四维意图信号（可同时触发）

信号	维度	常见触发词	CLI 子集（与其他信号取并集）
S1	理财产品	earn、Simple Earn、双币、质押、固定、灵活	cex earn 产品/发现命令
S2	收益率、风险、比较	APY、APR、风险、哪个更好、比较；产品侧 收益（产品或市场的回报——利率、档位、“这个产品收益怎么样”）	dual plans、staking find、check-token-security
S3	持仓和盈亏	我的理财、赚了多少、持仓、历史；持仓 收益（我的持仓累积的利息/奖励、理财盈亏和历史记录）	uni records、dual orders、fixed lends、staking orders、staking assets
S4	申购、赎回、配置	申购、赎回、加入、自动续期、参与	读取余额后调用 uni lend、fixed create、dual place、staking swap、uni change

收益关键词： 当查询中包含 收益（或收益率等表示收益含义的近义词）时，在同时激活两者之前，先区分 S2 和 S3：

• 产品收益：询问某个产品或条目的回报，或比较收益——APY/APR、年化利率、哪个选项收益更高。→ 针对此角度仅激活 S2；不要仅因这一线索激活 S3。
• 持仓收益：询问用户现有持仓赚了多少——累积利息、已获得的奖励、 “我赚了多少”、分项盈亏。→ 针对此角度仅激活 S3；不要仅因这一线索激活 S2。

其他信号（例如 S1、S4）仍会根据各自线索独立激活。

默认判断： 宽泛且不够具体的理财浏览会激活 S1+S2。“赚了多少”这类含糊查询倾向于激活 S3。如果出现 收益，但无法明确判断是产品收益还是持仓收益，优先简短追问；如果必须默认判断，当措辞暗示我的持仓时（例如 我 / 我的 / 累计 / 持仓），倾向于 S3；当措辞暗示目录或报价利率时（例如 哪个 / 年化 / 产品对比），倾向于 S2。

执行模式： 不含 S4 的 S1/S2/S3 仅用于研究（获取并总结信息）。如果激活了 S4，则进行研究并生成操作草案（Action Draft），只有在上一条用户消息中明确给出 Y 后，才执行写入操作。

不在范围内（转到其他技能）

• 现货/永续/期权交易执行（在订单簿上买入/卖出）→ 交易 copilot / gate-exchange-spot 或期货技能。
• 新上市研究、上市提醒 → 专用的上市/研究技能。
• 广泛市场或单币种的非理财研究 → 市场研究/信息研究技能。
• 与理财持仓无关的完整账户风险（强平、保证金）→ 账户或统一账户技能。

呈现规则

• 当用户要求分别查看理财分项（例如灵活利息与质押奖励）时，按产品分节呈现；除非用户明确要求总额，否则不要合并成一行“总利润”。
• 对于这类查询（包括**「余币宝利息 / 质押奖励分别赚了多少」），默认分析/导出时间范围为最近约三个月：对于可按时间筛选的读取操作（例如 uni interest-records、uni records），将 --from / --to 设置为 now − 90 days 至 now（CLI 使用 Unix 毫秒）。在回复中注明时间范围。只有用户要求终身 / 全部 / 累计历史等数据时，才使用完整历史**累计 API 或未分页总数。
• 对于双币等类似产品，如果 API 返回的是小数形式的 APY，则以易读的百分比形式呈现（例如在符合 CLI 输出语义时，显示前乘以 100）；如果存在歧义，应说明假设。
• 不要承诺固定回报；应清楚标注估算值和浮动收益。

工作流

当用户要求执行任何与理财相关的操作时，按以下顺序进行。

Step 1: 路由意图（赚币或非赚币）

如果请求显然与赚币、质押、双币、活期／定期储蓄或闲置资金赚币配置无关，请路由到相应的非赚币技能，而不是强行使用赚币 CLI。

Step 2: 提取参数并激活信号

尽可能提取：product_type（simple / dual / staking）、currency、amount、term 或 days、risk_preference，以及用户是否想要进行写入（S4）。如果查询包含收益，请在合并信号 CLI 集合前，按产品收益 → 仅 S2 / 持仓收益 → 仅 S3进行拆分。

Step 3: 构建 CLI 集合

• 合并每个已激活信号对应的 CLI（参见 Domain knowledge）。
• 去重参数完全相同的命令行。
• 在安全的情况下并行运行彼此独立的读取操作；写入操作则一次只执行一个已确认的操作。

Step 4: 执行前读取与综合

• 对于写入（S4），拟定操作前，始终使用 gate-cli cex spot account list 或 gate-cli cex spot account get 检查可用余额，视具体情况而定。
• 对每个叶子命令，遵循 references/gate-cli.md §2.1（必需标志前先运行 --help）。

Step 5: 任何写入操作的草案与确认（强制）

在执行**gate-cli cex earn uni lend、gate-cli cex earn uni change、gate-cli cex earn fixed create、gate-cli cex earn dual place或gate-cli cex earn staking swap**之前：

1. 提供一份操作草案（产品类型、币种、金额、指示性 APR 或条款，以及重要风险；如适用，包含双币行权／结算风险）。
2. 请用户回复 Y 以确认，或回复 N 以取消。确认视为仅单次有效；参数或意图变更时，必须重新提供草案。
3. 只有在用户上一条消息中立即回复 Y 后，才能执行写入操作。
4. 如果失败，不要自动重试写入操作；显示错误，并建议使用 App／Web 或修正参数。

Step 6: 结果与验证

• 写入操作完成后，在适当情况下使用相应的读取命令（记录、订单、借贷、质押订单）进行验证。
• 如果读取失败，请妥善降级处理：说明哪些信息维度不可用；绝不捏造余额或 APY。

案例路由图（1–15）

案例	用户意图	核心决策	工具序列（缩写）
1	闲置资金、低风险、寻找收益最佳组合	跨类型对保守型产品进行排名	并行：fixed products、fixed products-asset、uni rate、uni currency、dual plans → 汇总报告
2	比较某种币的双币投资与质押	比较 APR、锁定／行权说明，可选 check-token-security	dual plans + staking find + 可选 check-token-security
3	检查投资组合并寻找更好的产品	先查看持仓，再扫描市场	uni records、dual orders、fixed lends、staking orders → 给出建议；只有在草案后获得 Y 才写入
4	了解质押详情并参与	解释条款，然后可选 staking swap	staking find + 读取现货余额 → 草案 → 获得 Y 后执行 staking swap
5	自动续期／滚动策略	找出可续期的行；用户确认后执行 uni change	读取持仓 → 草案 → 获得 Y 后执行 uni change --json
6	灵活利率与最低利率	查询灵活参数	uni rate、uni currency
7	按收益率排序的资产定期产品	列出并排序定期产品	fixed products-asset
8	查找高收益质押产品	列出并排序质押产品	staking find
9	筛选双币投资计划（例如高位卖出 BTC）	按币种和产品类型筛选计划	dual plans
10	跨类型 APR 比较	提供并排表格，并附上方法说明脚注	uni rate、uni currency、fixed products-asset、staking find
11	按赚币类型分别计算盈亏	除非用户要求，否则不汇总不同类别；默认时间范围约为最近 3 个月（--from／--to ≈ 90d）；只有明确要求时才查询累计数据	按类别汇总／获取数据：灵活赚币使用带时间筛选的 uni interest-records（必要时加上 uni records）；staking awards（分页；如果 CLI 没有 --from／--to，则按行时间戳筛选）；staking assets 用于持仓快照；用户要求时，才使用 uni interest 查询累计的各币种总额
12	申购灵活赚币（例如 USDT）	查询余额与规则后再出借	现货余额 + uni currency → 草案 → 获得 Y 后执行 uni lend --json
13	申购定期产品	从产品中选择期限	fixed products-asset + 现货余额 → 草案 → 获得 Y 后执行 fixed create --json
14	赎回部分灵活赚币	检查可赎回金额后再赎回	uni records → 草案 → 获得 Y 后执行 uni lend --json 赎回
15	双币投资结算历史	筛选已结算的双币投资订单，并按币种汇总	dual orders、dual balance

判断逻辑摘要

条件	操作
查询中包含收益	将产品收益归类为 → 仅 S2（该角度）；将持仓收益归类为 → 仅 S3（该角度）；绝不能仅因同一处未区分的“收益”提及，同时启用 S2 和 S3
用户询问赚币收益、产品或比较，且未要求申购／赎回	仅使用 S1／S2／S3；读取文档中记录的 gate-cli 命令；不执行写入
用户要求申购、赎回、参与质押、下双币投资订单或更改自动续期	启用 S4；完成读取后生成操作草案；未获得 Y 前不得写入
用户将交易（“市价买入 BTC”）与赚币需求混在一起	将交易需求路由到现货／交易技能；仅在赚币部分可以明确区分时处理该部分
check-token-security 返回空结果或报错	跳过或标注“风险数据不可用”；不得仅因此阻止只读查询
用户想按类别查看赚币盈亏	使用案例 11 的模式；分开列示；除非用户要求全部时间数据，默认数据范围 = 最近约 90 天
确认已过期或含糊不清	重新提供操作草案；不得执行写入
多步写入（例如先赎回再申购）	每个写入步骤都必须获得单独确认

报告模板

## Earn Result

| Item | Value |
|------|-------|
| Scenario | {case_name} |
| Product | {product_type} |
| Currency | {currency} |
| Status | {status} |
| Key metrics | {apr_or_amounts} |

{decision_text}

decision_text 示例：

• 操作草案：灵活型 USDT 理财，金额 2000 USDT，参考年化收益率 {x}%，风险：收益浮动。回复 Y 确认，或回复 N 取消。
• 只读摘要：按年化收益率排序的固定期限 USDT 理财产品（见表格）。未执行申购。
• 未执行：可用余额低于请求金额。

错误处理

错误类型	常见原因	处理策略
余额不足	现货可用余额不足以申购	显示差额；建议减少金额或充值
产品不可用	期限售罄或不支持该币种	说明原因；刷新产品列表
身份验证或权限失败	密钥缺少理财或现货读取权限	停止写入操作；指导修复凭据和权限范围
缺少确认	用户未发送 Y	保留待处理草案；仅执行读取操作
确认已过期	自发送 Y 后参数已变更	使确认失效；重新起草
CLI 部分失败	一项并行读取失败	继续读取其他维度；标注缺失项
写入失败	交易所拒绝订单	不自动重试；显示提示；建议使用 App/Web

安全规则

• 未先生成操作草案，且未在紧接着的上一条用户消息中收到明确的 Y，绝不调用理财写入命令。
• 双币产品存在行权／结算风险；在确认任何 dual place 操作前，必须明确说明这一点。
• 不得保证收益或暗示零风险。
• 金额、币种、产品或方向发生任何实质性变化后，确认即失效。
• 当宿主工作流需要机器解析时，优先使用 --format json（根据操作员策略可选）。

跨技能工作流

• **先转入现货，再进行理财：**如果现货余额不足，用户可能需要先使用现货划转或充值技能（本技能仅检查并报告）。
• **赎回后交易：**成功赎回至现货后，可使用交易技能；不得将下单与理财写入操作混为一谈。