gate-exchange-launchpool

解析 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 LaunchPool 套件

通用规则

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

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

技能依赖项

使用的 gate-cli 命令

查询操作（只读）

• gate-cli cex launch pledge-records
• gate-cli cex launch projects
• gate-cli cex launch reward-records

执行操作（写入）

• gate-cli cex launch pledge
• gate-cli cex launch redeem

身份验证

• 交互式文件设置： 如果主机上未同时设置 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——绝不要要求用户在聊天中粘贴密钥。
• 权限： Launch: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，然后执行此技能的 LaunchPool 工作流。

• SKILL.md 负责路由和产品语义。
• references/gate-cli.md 是项目／记录查询、质押赎回确认关卡和结果验证方面的权威 gate-cli 执行规范。

模块概览

模块	描述	触发关键词
Projects	浏览 LaunchPool 项目列表，按状态/APR/币种/池类型筛选	projects、activities、events、ongoing、ended、warming up、APY、APR、which LaunchPool
Stake	将代币质押到 LaunchPool 项目	stake、participate、join、pledge、contribute、put in
Redeem	提前赎回项目中已质押的资产	redeem、withdraw、unstake、take out、exit、pull out
Pledge Records	查询质押/赎回参与历史	pledge records、participation history、staking records、my LaunchPool history
Reward Records	查询空投奖励发放历史	airdrop、rewards、earnings、reward records、airdrop history、LaunchPool income

领域知识

LaunchPool 概念

概念	描述
LaunchPool	一个平台功能，用户可质押现有代币以赚取新代币空投。项目有固定的质押期。
Project (pid)	针对特定新代币的 LaunchPool 活动。包含开始/结束时间、奖励池总额和质押规则。
Reward Pool (rid)	一个项目中，不同质押币种对应不同的奖励池（例如 USDT 池、BTC 池）。每个池都有自己的预估 APR。
Staking Period	用户可以质押并赚取奖励的期限。期限结束后会发放奖励。
Estimated APR	rate_year — 奖励池的预估年化利率（简单计息，不复利）。用户可能会口语化地称其为“APY”；输出时始终显示为“预估 APR”。
Newbie Pool	面向新用户的特殊池，准入要求较低或提供额外奖励（limit_rule=1）。
Normal Pool	面向所有用户开放的标准质押池（limit_rule=0）。
Status (project_state)	项目生命周期：预热中（2）→ 进行中（1）→ 已结束（3）。请求参数 status 也支持 0（全部）和 4（进行中 + 预热中）。
Personal Limit	每位用户在每个奖励池中的最高/最低质押金额（personal_max_amount / personal_min_amount）。
Transaction Config	根据用户 **60 天总交易额（USD）**设定的分级参与条件。每个等级都定义一个 transaction_amount 门槛，以及对应的 mortgage_limit（个人质押上限，单位与奖励池的质押币种 coin 一致）。如果用户的交易额低于最低等级，则质押上限为 0（不符合参与条件）。transaction_config 数组为可选项——仅部分奖励池包含此配置。

时间戳格式

质押/奖励记录中的 create_timest 和 reward_timest 字段是 API 返回的预格式化字符串（例如“2026-03-16 09:32:22”）。在数据行中按原样显示，并在表格标题中标注 (UTC)，不要在每个值后追加。

项目时间字段（start_timest、end_timest）属于内部数据——不要向用户显示。

奖励记录时间参数：奖励记录 API 要求 start_time/end_time 使用整数 Unix 时间戳，计算时容易出错。请遵循 references/records.md 中的时间戳策略（策略 1：查询近期记录时跳过时间参数；策略 2：使用锚点表查询历史时间范围）。没有锚点表时，不要尝试自行计算 Unix 时间戳。

数字格式

类别	精度	示例
金额（质押、赎回、奖励）	8 位小数，去掉末尾的零	1.23，而不是 1.23000000
利率字段（预估 APR）	2 位小数，保留末尾的零	5.20%，而不是 5.2%

路由规则

意图	示例短语	路由到
浏览项目	“显示 LaunchPool 项目”“当前有哪些 LaunchPool 活动？”“APR 最高的 LaunchPool”“有 USDT LaunchPool 吗？”“新手池项目”	阅读 references/launch-projects.md
申购	“将 500 USDT 申购到 LaunchPool BTC 项目”“我想参与 LaunchPool”“将 1000 USDT 投入 LaunchPool”	阅读 references/stake-redeem.md（申购部分）
赎回	“赎回我的 LaunchPool BTC 申购”“从 LaunchPool 提款”“从 LaunchPool 赎回我的 USDT”	阅读 references/stake-redeem.md（赎回部分）
申购记录	“我上个月参与 LaunchPool 的记录”“显示我的 LaunchPool 申购记录”“查看我的 BTC LaunchPool 申购历史”	阅读 references/records.md（第 1 部分：申购记录）
奖励记录	“我的 LaunchPool 空投奖励”“查看本月 LaunchPool 收益”“显示我的 BTC LaunchPool 空投”	阅读 references/records.md（第 2 部分：奖励记录）
不明确	“LaunchPool”“launch pool”	澄清：项目 / 申购 / 赎回 / 申购记录 / 奖励记录，然后路由

执行

1. 意图和参数

• 确定模块（项目 / 申购 / 赎回 / 申购记录 / 奖励记录）。
• 申购意图：如果用户想申购代币，路由到 references/stake-redeem.md 的申购部分。需要识别项目、确定金额并获得用户确认。
• 赎回意图：如果用户想赎回，路由到 references/stake-redeem.md 的赎回部分。需要识别项目、确定金额并获得用户确认。
• 提取参数：coin、pid、rid、amount、status、sort_type、limit_rule、page、start_time、end_time。
• 缺少信息：如果用户只说“LaunchPool”而未指定意图，询问要执行哪种操作，或默认显示项目。

2. 工具选择

模块	MCP 工具	必需参数	可选参数
项目	gate-cli cex launch projects	page、page_size	status、sort_type、mortgage_coin、search_coin、limit_rule
申购	gate-cli cex launch pledge	body（JSON：pid、rid、amount）	—
赎回	gate-cli cex launch redeem	body（JSON：pid、rid、amount）	—
申购记录	gate-cli cex launch pledge-records	—	coin、type、start_time、end_time、page、page_size
奖励记录	gate-cli cex launch reward-records	page、page_size	coin、status、start_time、end_time

• 申购：先调用 gate-cli cex launch projects，确定目标项目的 pid 和奖励池 rid，然后显示预览并等待确认，最后调用 gate-cli cex launch pledge。
• 赎回：先显示赎回预览并等待确认，然后调用 gate-cli cex launch redeem。

3. 设置响应格式

• 对所选模块，使用参考文件中的响应模板和字段名称。
• 项目：显示 name、project_state、total_amount、days，以及每个奖励池的 coin、rate_year、already_buy_total_amount、personal_max_amount/personal_min_amount、transaction_config。不要显示 start_timest/end_timest、pid 或 rid。
• 申购/赎回：先显示订单预览，再显示确认结果。申购返回 flow_id；赎回返回布尔值 success。
• 申购记录：显示 create_timest、reward_coin、coin、amount、type（1=申购，2=赎回）。注意：API 不返回项目名称。
• 奖励记录：显示 reward_timest、coin（奖励币种）、valid_mortgage_amount、amount_base、amount_ext。注意：API 不返回项目名称。

报告模板

每次操作后，输出简短、标准化的结果，并与参考内容保持一致（例如，项目列表表格、质押确认、赎回确认、质押记录列表、奖励记录列表）。使用 API 中的准确响应字段（参见参考内容），确保用户看到正确的字段名称和值。

语言适配：始终使用与用户输入相同的语言进行回复。参考文件中的响应模板定义了要显示的结构和字段，而非输出内容的固定语言。将所有显示标签翻译成与用户语言相符的内容。

请勿翻译（无论使用何种语言，都保持原样）：

• 产品名称：LaunchPool
• API 中的货币符号：USDT、GT、BTC、DOGE 等
• API name 字段中的项目名称（例如，“DOGE”“USDT-rudy”）
• 技术 ID 及其值：pid、rid、flow_id（仅供内部使用，请勿向用户显示）
• 包含 (UTC) 后缀的时间戳格式
• API 错误标签：INVALID_PARAM_VALUE、INSUFFICIENT_BALANCE、INVALID_CREDENTIALS、PROJECT_NOT_FOUND
• 数值、百分比，以及交易量门槛中的单位 USD

其他所有显示标签都应翻译成与用户语言相符的内容。

错误处理

API 错误标签

API 会返回带有 label 字段的结构化错误。按以下方式映射：

API 标签	面向用户的消息
INVALID_PARAM_VALUE	“请求参数无效。请检查输入并重试。”
INVALID_CREDENTIALS	“请登录以使用 LaunchPool 功能。”
INSUFFICIENT_BALANCE	“余额不足。请先充值。”
PROJECT_NOT_FOUND	“未找到指定的 LaunchPool 项目。”

空结果处理

场景	操作
项目列表为空	“没有符合条件的 LaunchPool 项目。请尝试其他筛选条件，或稍后再来查看。”
质押记录为空	“您没有 LaunchPool 参与记录。浏览正在进行的项目即可开始参与。”
奖励记录为空	“未找到空投奖励。奖励通常会在质押期结束后发放。”
合规限制	“由于合规限制，您所在的地区无法使用 LaunchPool。”
超出质押限额	“此项目设有个人质押限额。请减少质押金额。”
API 错误 / 401	“无法获取 LaunchPool 数据。请稍后重试。”或“请登录以使用 LaunchPool 功能。”

安全规则

必须确认

• 质押和赎回是写入操作。 在调用 gate-cli cex launch pledge 或 gate-cli cex launch redeem 之前，必须展示订单预览并等待用户明确确认。
• 预览格式：项目名称、质押币种、金额、预计年化收益率（质押时）、质押期限。
• 请用户回复“确认”以继续，或回复“取消”以中止。
• 只有在收到用户明确确认后，才能调用 API。

合规性

• 当 API 返回合规或地区限制错误时，显示友好提示：“由于合规限制，您所在的地区无法使用 LaunchPool。”请勿重试。