gate-exchange-welfare

解析 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 交易所福利中心

通用规则

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

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

技能依赖项

使用的 gate-cli 命令

查询操作

• gate-cli cex welfare identity
• gate-cli cex welfare beginner-tasks

执行操作

• cex_welfare_claim_task（在 gate-cli/cmd/cex 中没有对应的 gate-cli 映射；参见 MCP_LEGACY_TOOL_RESOLUTION.md 第 2 节）
• cex_welfare_claim_reward（在 gate-cli/cmd/cex 中没有对应的 gate-cli 映射；参见 MCP_LEGACY_TOOL_RESOLUTION.md 第 2 节）

身份验证

• 交互式文件设置： 当主机上未同时设置 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 密钥：是
• 权限： 当前 Gate MCP 部署中的福利查询和领取权限
• 门户： 在聊天之外创建或轮换密钥：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 执行规范。

概览

福利中心新手技能，第 2 阶段。当用户询问福利、新手奖励、领取任务、完成任务或领取奖励时，首先确定用户是否符合条件。然后指导受限用户／老用户、展示真实的新手任务、领取单个任务、指导完成任务，或领取当前所有可领取的新手奖励。

触发场景：当用户提及福利、 新手奖励、任务列表、领取任务、完成福利任务或领取新手奖励时，执行此技能。

---

领域知识

资格代码

• code=0：符合条件的新用户
• code=1001：老用户
• code=1002：风控用户
• code=1003：子账户
• code=1004：Agent 用户
• code=1005：做市商
• code=1006：企业用户
• code=1008：未登录

新手任务列表语义

• 新手任务列表通过 gate-cli cex welfare beginner-tasks 获取。
• 注册任务会在引导任务之前返回。
• 如果用户尚未领取下载任务，且系统判定尚未下载 App，列表中可能会包含一个下载任务，其 task_type=23 且 status=0。
• task_desc 可能包含 <span> 等简单 HTML；仅展示文本内容，不要展示原始标签。

任务类型说明

• task_type=10：注册任务
• task_type=23：下载任务
• 引导任务可能会出现以下任务场景代码：
• 1：KYC／身份认证
• 2：现货交易
• 3：合约交易
• 8：首次充值
• 部分实时负载可能会使用其他受支持的任务场景值。请遵循实际的 MCP 负载，不要超出上述文档映射进行硬编码假设。

状态映射

状态	含义	处理方式
0	未领取／可领取任务	可调用 cex_welfare_claim_task（gate-cli/cmd/cex 中无 gate-cli 映射；参见 MCP_LEGACY_TOOL_RESOLUTION.md §二）
1	已领取／进行中	用户应完成任务操作
2	已完成，可领取奖励	可调用 cex_welfare_claim_reward（gate-cli/cmd/cex 中无 gate-cli 映射；参见 MCP_LEGACY_TOOL_RESOLUTION.md §二）
3	奖励发放中	告知用户奖励正在处理中
4	已完成／已结算	告知用户任务已完成
5	已过期	告知用户任务已过期

奖励中心

• 官方入口：https://www.gate.com/zh/rewards_hub
• 如果 API 无法返回可靠的操作结果，请使用官方网页／App 福利中心作为备用方案。

---

路由规则

用户意图	关键词／模式	路由
查询福利／奖励／任务列表	"有哪些福利"、"我可以做哪些任务"、"新用户任务"、"福利奖励"	执行此技能 → 先进行身份校验
领取任务	"领取任务"、"领取下载任务"、"接收任务"	执行此技能 → 身份校验 → 列出任务 → 领取一个 status=0` 的任务
完成 KYC 任务	"完成身份认证任务"、"完成 KYC 任务"	执行此技能 → 提供通用的 KYC 指引
完成首次充值任务	"完成首次充值任务"、"如何完成充值任务"	执行此技能 → 提供通用的充值指引
完成首次交易任务	"完成首次交易任务"、"我想进行首次交易"	执行此技能 → 转交给 gate-exchange-trading
完成任务（意图不明确）	"完成任务"、"完成我的福利任务"	执行此技能 → 身份校验 → 列出可操作的任务 → 确定任务
领取奖励／领取全部奖励	"领取奖励"、"领取全部奖励"、"领取新手奖励"	执行此技能 → 身份校验 → 列出任务 → 领取所有 status=2` 的任务
资产查询	"查看我的余额"、"我有多少 USDT"	路由到 gate-exchange-assets

---

执行

步骤 1：确定用户身份

每次处理福利意图时，先调用 gate-cli cex welfare identity。

根据 code 分支：

• 0 → 新用户流程
• 1001 → 现有用户指引
• 1002/1003/1004/1005/1006/1008 → 对应的限制指引
• 其他失败 / 超时 / HTTP 4xx → 降级兜底

基础流程：查询或列出新用户任务

触发条件：用户询问有哪些新用户福利 / 任务 / 奖励。

必需流程：

1. 调用 gate-cli cex welfare identity。
2. 如果 code=0，调用 gate-cli cex welfare beginner-tasks。
3. 如果列表结果为 code=1007 或任务列表为空，返回无任务兜底内容。
4. 展示每项实际任务，包含：

• task_name
• 移除 HTML 标签后的 task_desc
• reward_num
• reward_unit
• status

5. 根据 status 指明每项任务的下一步：

• 0：可以领取
• 1：完成任务操作
• 2：可以领取奖励
• 3：奖励正在发放
• 4：已完成
• 5：已过期

情况 1：领取单项任务

触发条件：用户要求领取某项任务，通常是下载任务。

必需流程：

1. 调用 gate-cli cex welfare identity。
2. 调用 gate-cli cex welfare beginner-tasks。
3. 查找 status=0 的可领取任务。
4. 确定目标任务：

• 如果用户指定了任务，按 task_name 匹配。
• 如果恰好只有一项可领取任务，则使用该任务。
• 如果有多项可领取任务且意图不明确，询问用户要领取哪项任务。

5. 使用选定的 welfare_task_id 调用 cex_welfare_claim_task（gate-cli/cmd/cex 中没有对应的 gate-cli 映射；参见 MCP_LEGACY_TOOL_RESOLUTION.md §二）。
6. 成功后，确认已领取的任务名称，并提醒用户完成任务后再领取奖励。

对于状态不是 0 的任务，不要调用 cex_welfare_claim_task（gate-cli/cmd/cex 中没有对应的 gate-cli 映射；参见 MCP_LEGACY_TOOL_RESOLUTION.md §二）。

情况 2：完成身份验证任务

触发条件：用户要求完成 KYC / 身份验证新用户任务。

必需行为：

• 不要调用福利写入工具。
• 提供通用的 KYC 指引，例如：

Please complete identity verification in Gate web or the Gate App first. After the verification is approved and the newcomer task becomes claimable, come back to the welfare center to claim the reward.

情况 3：完成首次充值任务

触发条件：用户要求完成新用户首次充值任务。

必需行为：

• 不要调用福利写入工具。
• 提供通用的充值指引，不要虚构门槛：

Please complete your first deposit in Gate web or the Gate App using the deposit flow shown there. Deposit requirements, supported assets, and any threshold conditions follow the Rewards Hub display. After the deposit is credited and the task becomes claimable, come back to claim the reward.

情况 4：完成首次交易任务

触发条件：用户要求完成新用户首次交易任务。

→ 阅读 gate-exchange-trading/references/execution-and-guardrails.md

必需行为：

• 转交给 gate-exchange-trading。
• 如果用户尚未说明要交易什么，让交易技能收集交易品种 / 方向 / 数量，并遵循其自身的操作草案及确认规则。

情况 5：完成任务的意图不明确

触发条件：用户只说“完成任务”或类似表述。

必需流程：

1. 调用 gate-cli cex welfare identity。
2. 调用 gate-cli cex welfare beginner-tasks。
3. 根据状态 0 和 1，整理可执行的任务集合。
4. 如果有多项可执行任务，询问用户想完成哪项任务。
5. 如果恰好只有一项可执行任务：

• status=0 → 使用情况 1
• 任务描述或 task_type 表明是 KYC → 使用情况 2
• 任务描述或 task_type 表明是首次充值 → 使用情况 3
• 任务描述或 task_type 表明是交易 → 使用情况 4
• 否则，提供通用的完成指引，并引导用户前往福利中心

案例 6：领取奖励

触发条件：用户要求领取奖励 / 领取所有奖励。 必需流程：

1. 调用 gate-cli cex welfare identity。
2. 调用 gate-cli cex welfare beginner-tasks。
3. 筛选 status=2 的任务。
4. 如果没有符合条件的任务，告知用户目前没有可领取的新手奖励。
5. 对于一般的“领取奖励”意图，遍历所有 status=2 的任务，并逐一调用 cex_welfare_claim_reward（gate-cli/cmd/cex 中没有对应的 gate-cli 映射；参见 MCP_LEGACY_TOOL_RESOLUTION.md §二）。
6. 对于每次成功领取：

• 优先使用领取响应中的 coupon_full_name。
• 如果 coupon_full_name 为空，则回退使用任务的 reward_num + reward_unit。

7. 如果某个任务返回 has_m_n_task=true，不要为该任务完成奖励发放。应引导用户前往 Gate 网页版/App 奖励中心手动领取。

---

响应模板

现有用户引导

Please visit Gate web at https://www.gate.com/zh/rewards_hub or open the Gate App to view welfare activities, exclusive benefits, and reward redemption items.

新手任务列表

Your newcomer welfare tasks:

- {task_name}
 Description: {task_desc_without_html}
 Reward: {reward_num} {reward_unit}
 Status: {mapped_status}
 Next step: {claim task / complete task / claim reward / distributing / completed / expired}

任务领取成功

Successfully claimed {task_name}. Complete the task first, then you can claim {reward_num} {reward_unit}.

奖励领取成功

You have claimed these newcomer rewards:

- {task_name}: {coupon_full_name_or_reward_num_reward_unit}
- {task_name}: {coupon_full_name_or_reward_num_reward_unit}

M选N 奖励回退处理

This reward must be claimed from Gate web at https://www.gate.com/zh/rewards_hub or from the Gate App welfare center.

---

错误处理

异常类型	处理方式
现有用户（code=1001）	显示奖励中心引导
风控用户（code=1002）	“您的账户暂时无法参与福利活动。详情请联系客服。”
子账户（code=1003）	“子账户无法参与此福利活动。请使用主账户登录。”
Agent 用户（code=1004）	“Agent 用户无法参与此福利活动。”
做市商（code=1005）	“做市商用户无法参与此福利活动。”
企业用户（code=1006）	“企业用户无法参与此福利活动。”
无任务数据（code=1007）	“目前没有正在进行的新手福利任务。请查看奖励中心，了解更多活动。”
未登录（code=1008）	“请先登录您的 Gate 账户。”
身份/列表查询超时或 MCP 不可用	“福利信息暂时不可用。请稍后重试，或直接访问 https://www.gate.com/zh/rewards_hub。”
领取任务：活动无效（51501009）	告知用户该任务已失效或不可用
领取任务：已领取 / 未满足条件（51501010）	告知用户该任务无法重复领取，或尚未满足领取条件
领取任务或奖励：风控拒绝（51501026）	告知用户该账户暂时不符合福利中心的参与资格
领取奖励：请再次刷新（51501027）	请用户刷新/重新检查任务列表，然后重试
领取奖励：任务已过期（51501034）	告知用户奖励领取期限已过
领取奖励：记录不存在（51501004）	告知用户奖励记录已不可用，并建议刷新任务列表
HTTP 4xx 且包含标准 label + message	简要显示网关错误并停止；不能仅凭 HTTP 200 就判定成功

---

跨技能集成

用户后续意图	路由目标
用户想进行首次交易	gate-exchange-trading
用户指定仅进行现货交易操作	gate-exchange-spot
用户询问一般资产余额	gate-exchange-assets
用户询问与福利完成引导无关的一般 KYC 状态/详情	gate-exchange-kyc

---

安全规则

1. 先进行身份验证：在展示新手任务详情、领取任务或领取奖励之前，始终先调用 gate-cli cex welfare identity。
2. 仅使用允许的工具：仅使用此技能中说明的四个 MCP 工具。
3. 以业务代码为准：成功或失败由响应中的 code 决定，不能仅凭 HTTP 200 判断。
4. 仅使用真实数据：绝不编造任务名称、描述、奖励数量、奖励单位或奖励标题。
5. 清理任务描述：向用户展示文本前，先从 task_desc 中移除原始 HTML 标签。
6. 领取任务的前置条件：仅可对当前任务列表中 status=0 的所选任务调用 cex_welfare_claim_task（在 gate-cli/cmd/cex 中没有对应的 gate-cli 映射；参见 MCP_LEGACY_TOOL_RESOLUTION.md §二）。
7. 领取奖励的前置条件：仅可对当前显示为 status=2 的任务调用 cex_welfare_claim_reward（在 gate-cli/cmd/cex 中没有对应的 gate-cli 映射；参见 MCP_LEGACY_TOOL_RESOLUTION.md §二）。
8. 处理 M 选 N 任务：如果 has_m_n_task=true，不要称奖励已领取。引导用户前往官方奖励中心/App。
9. 此处不处理无关的交易写入操作：存款执行和交易执行不属于此技能的范围。请将用户引导至相应的产品技能。
10. 安全回退：如果 MCP 数据不可用或不一致，请引导用户前往 https://www.gate.com/zh/rewards_hub，不要猜测。