gate-exchange-assetswap

解析 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 交易所资产配置优化

通用规则

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

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

技能依赖

使用的 gate-cli 命令

查询操作（只读，配置范围）

• gate-cli cex assetswap assets
• gate-cli cex assetswap config
• gate-cli cex assetswap evaluate
• gate-cli cex assetswap order list
• gate-cli cex assetswap order get

执行操作（写入，交易范围）

• gate-cli cex assetswap order preview
• gate-cli cex assetswap order create

身份验证

• **交互式文件设置：**如果主机上未同时设置 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 密钥：是
• **权限：**列出、配置、评估和查询订单需要 Profile（读取）权限；预览和创建订单需要 Trade 权限
• **门户：**请在聊天之外创建或轮换密钥：https://www.gate.com/myaccount/profile/api-key/manage

安装检查

• **必需：**启用了资产配置优化工具的 Gate（主）MCP（MCP 名称为 cex_assetswap_*）；从主机 CLI 运行时，优先使用 gate-cli cex assetswap …。
• 安装（MCP／IDE）：gate-mcp-cursor-installer、gate-mcp-codex-installer、gate-mcp-claude-installer 或 gate-mcp-openclaw-installer。
• 凭据：如果主机已同时设置非空的 GATE_API_KEY 和 GATE_API_SECRET，则不需要运行 gate-cli config init。如果两者均未设置或为空，请提醒操作者运行 gate-cli config init，或在技能库中对应的匹配技能内配置 GATE_API_KEY／GATE_API_SECRET（绝不要要求用户在聊天中粘贴密钥）。
• **健全性检查：**预览或创建订单前，确认运行时正常工作（例如，执行 gate-cli --version 或进行特定于部署的检查）。

---

触发条件

当用户有以下任一需求时，启用此技能：

• 将多种现货资产投资组合优化或再平衡为某种策略（保守型稳定币、单一高确信度资产或按市值加权的组合）
• 查看哪些现货余额符合资产配置优化条件
• 在确认前预览预计执行情况、滑点或风险提示
• 确认后提交资产配置优化订单
• 查询历史配置优化订单，或查询某个订单的状态及子订单

以下情况不要使用此技能：账户或产品之间的转账、Launchpool 或赚币申购、不涉及资产配置产品的单笔手动现货限价单或市价单，或低于产品门槛的零散资产处理（应改用相应的转账、赚币、现货或小额余额产品技能）。

---

数据隐私与收集

• AI 交互信息：遵循此技能时使用的用户提示、后续指令和工具参数均属于 Gate 隐私政策所述的 AI 交互数据（参见 §4.2.7）。不要在面向用户的输出中询问或重复 API 密钥、机密或无关的个人数据。
• 数据流：此技能涉及的账户和交易数据仅通过已配置的 Gate（主）MCP，经由上述资产互换工具流向 Gate Exchange API（MCP cex_assetswap_* 或等效的 gate-cli cex assetswap … 调用）。在此工作流中，不要将相同数据转发给未记录的第三方服务、爬虫或自定义后端。
• 最小化：每次已记录的 MCP 调用仅传递必需参数（交易对、金额、策略字段、分页参数）。不要将完整聊天记录或无关上下文传入工具负载。

---

领域知识

产品：资产配置优化提供 Exchange 功能，可将多种现货持仓重新配置为目标组合。一次优化在订单层可能对应多个内部执行环节。

策略类型（概念性说明；具体枚举值和参数以 gate-cli cex assetswap config 为准）：

策略	典型目标	含义
保守型	USDT、GUSD、USDC（示例）	将资产整合为单一稳定币；采取避险或闲置现金策略
高确信度（“faith”）	BTC、ETH、GT（示例）	将选定的现货资产重新配置为所选资产的目标权重；中间步骤遵循产品和 API 规则
市值加权	Top 2、Top 5（示例）	按市值加权配置到类似指数的资产组合中，例如 BTC、ETH、SOL、BNB、XRP（实际列表以 API 为准）

资产列表规则（供 Agent 解读；产品可能会在服务端进行筛选）：

• 默认展示可能会排除主要储备资产（例如 BTC、ETH、USDT、USDC），除非用户明确要求将其纳入卖出资产集合。
• 只有可用现货余额会参与；赚币、借贷、质押或类似产品中的锁定余额不在范围内。
• 可能会隐藏非常小的余额（例如折合金额低于约 10 USD），或将其转交小额余额处理；具体门槛以 API 或产品规则为准。

公开技能文档不涵盖的内容（不要将其记录为标准 Exchange MCP 功能）：

• 横幅或仅限 UI 的功能开关
• 未作为 Exchange MCP 发布的非标准语义型“验证并填充参数”辅助工具

速率限制：遵循有记录的钱包或 Exchange API 限制（例如每个用户或密钥每 10 秒 200 次请求）；请参阅已发布的 API 文档予以确认。

预览 → 创建负载（Agent 必须遵守）：

• 在 gate-cli cex assetswap order preview 成功后，仅根据预览响应中的 data.order 构造 gate-cli cex assetswap order create 请求体：对 data.order.from 和 data.order.to 中的每个对象，使用预览返回的 asset 和 amount 字符串字段，生成 { "asset": <value>, "amount": <value> }（使用 amount，而非 amount_show，除非已发布的 API 文档另有说明）。
• 严格按照 data.order 返回的 to（以及存在多个资金腿时的 from）数组顺序保留条目；不要为了方便而重新排列币种。
• 预览请求的 to 可以使用 ratio；但 create 调用仍必须使用预览输出中已解析的 asset + amount 资金腿。如果 to 仅使用 ratio 而省略预览金额，通常会导致报价错误（例如 code: 4）。
• 如果 API 返回其他与预览相关的字段（例如顶层的 usdt_evaluated_value 或 data 内的 transaction_fee），则在 MCP 或 Exchange 文档要求时，也应在 create 中一并传入；否则，预览返回的 from / to 资金腿是主要约定。

主要流程（下单时必须按此顺序）：

1. 案例 1 — 列出符合条件的资产
2. 案例 2 — 获取策略和参数配置
3. 案例 3 — 交易前评估与预览（3a 可选；根据产品规则，3b 强烈要求或必须执行）
4. 案例 4 — 明确获得用户确认预览后创建订单

除非产品规则明确允许，否则不得从案例 2 直接跳到案例 4，必须先执行案例 3b 预览。

补充查询（不得改变主要流程的顺序）：

• 案例 5 — 分页查询订单列表
• 案例 6 — 查询单笔订单详情

订单状态（示例）：配置中、已完成、部分完成、失败 — 使用响应中的 API 字段名称和值。

工具范围摘要：

工具	类型	范围
gate-cli cex assetswap assets	读取	profile
gate-cli cex assetswap config	读取	profile
gate-cli cex assetswap evaluate	读取	profile
gate-cli cex assetswap order list	读取	profile
gate-cli cex assetswap order get	读取	profile
gate-cli cex assetswap order preview	写入	trade
gate-cli cex assetswap order create	写入	trade

合规性：API 会执行受限地区、KYC 和账户禁用等限制。遇到合规错误时，转达错误信息并停止；不要承诺平台无法保证的结果。

Agent 不得：保证盈亏、VIP 等级变更或绕过资格规则。

---

工作流

步骤 1：明确用户目标，并将资产配置优化以外的请求转交处理

将请求归类为：(A) 仅查询信息，(B) 完成从预览到可选下单的整个优化流程，(C) 查询历史记录或单笔订单状态。

仅根据用户消息和会话上下文推断意图并确定路由。在此步骤中不得调用任何 cex_* MCP 工具。如果用户想进行单笔常规现货下单、转账、网格机器人或 赚币操作，请停止使用此技能，并转交给相应的 Gate Exchange 技能。

需要提取的关键信息：

• goal：list_only | evaluate_only | preview | place_order | order_list | order_detail
• strategy_hint：conservative | conviction | market_cap | unknown（通过 config 确认）
• symbols_or_scope：用户希望纳入或排除的资产

步骤 2：案例 1 — 列出符合优化条件的资产

根据 MCP 和 API 文档提供参数（不得使用未记录的字段），调用 gate-cli cex assetswap assets。

需要提取的关键信息：

• eligible_assets：API 返回的币种、可用金额和估值参考信息
• 用户是否需要缩小范围，以便进行后续步骤

步骤 3：案例 2 — 加载配置

调用 gate-cli cex assetswap config，传入：除非 API 指定可选筛选条件，否则无需提供请求正文；获取允许的策略、目标、限制和精度规则。

需要提取的关键数据：

• allowed_strategies，以及 TopN、目标资产和限制的参数结构
• 构建下一步请求负载时，Agent 必须遵守的约束

步骤 4：案例 3a — 评估（可选）

当用户需要在确定最终参数前快速估算，或在调整策略选项时：

调用 gate-cli cex assetswap evaluate，传入：API 对所选资产和策略要求的负载。

需要提取的关键数据：

• evaluation_summary：预估名义金额或其他返回的指标
• 任何警告或验证错误

步骤 5：案例 3b — 预览订单（正常流程中创建订单前必需）

用户确认资产集合和策略参数后：

调用 gate-cli cex assetswap order preview，传入：API 文档中规定的候选选择和策略字段。

清晰地展示预览结果：预计成交情况、滑点或风险提示，以及任何服务端通知。获取用户的明确确认后，才能继续步骤 6。

如果市场发生变动或预览过期，请重复步骤 5（必要时也重复步骤 4），然后再创建订单。

需要提取的关键数据：

• preview_reference_fields：步骤 6 所需的任何报价、令牌或到期字段（严格遵循响应结构）
• create_from_legs：将 data.order.from 中的内容复制并精简为每个元素的 { asset, amount }（取自预览中的 amount，而不是 amount_show）
• create_to_legs：将 data.order.to 中的内容复制并精简为每个元素的 { asset, amount }，顺序必须与预览相同
• user_confirmed：布尔值 — 只有值为 true 才能继续

步骤 6：案例 4 — 创建优化订单

仅在预览成功且获得明确确认后：

调用 gate-cli cex assetswap order create，传入：JSON 请求正文，其中 from 为步骤 5 中的 create_from_legs，to 为步骤 5 中的 create_to_legs（每条腿都取自 data.order 中的 asset + amount）。仅当文档或反复失败表明有必要时，才添加 API 要求的其他预览关联字段（例如 data 下的 usdt_evaluated_value 或 transaction_fee）。如果预览已返回每个目标资产的具体 amount，此步骤中不要改用仅包含比例的 to。

需要提取的关键数据：

• order_id 或等效标识符
• 初始状态和时间戳
• 后续操作指引（查询详情或查看历史记录）

步骤 7：案例 5 — 列出订单（补充）

用户询问近期历史记录时：

调用 gate-cli cex assetswap order list，传入：API 规定的分页参数（例如产品定义的近期月份）。

需要提取的关键数据：

• orders[]：标识符、状态、创建时间
• 如果有，提取分页游标或标志

步骤 8：案例 6 — 订单详情（补充）

用户提供订单 ID 或从列表中选中一个订单时：

调用 gate-cli cex assetswap order get，传入：MCP 和 API 文档规定的 order_id 字符串。

需要提取的关键数据：

• 汇总状态，以及返回的各子订单状态
• API 返回的已消耗和已接收金额

---

错误处理

情况	操作
预览已过期或价格无效	重新运行 gate-cli cex assetswap order preview（如有需要，也重新评估）；简要说明原因
预览成功后，创建订单返回报价错误	确认创建请求体使用 data.order.from / data.order.to 中的 asset + amount（保留预览订单内容）；重新预览并重试；如果预览已返回金额，避免仅使用比例作为 to
可用余额不足	停止创建订单；请用户释放余额或调整选择
触发速率限制	等待一段时间后重试；显示 API 消息
合规或地区限制	停止操作；转达合规消息；不要通过变通方式重试
部分完成	根据 gate-cli cex assetswap order get 报告实际状态；不保证完成时间

---

安全规则

• 交易风险：数字资产交易涉及重大风险，可能导致投资部分或全部损失。请参阅 Gate 风险披露 和 用户协议。
• 除非用户自己的明确单次授权符合此产品的运行时规则（默认要求确认），否则绝不在预览成功且用户明确确认预览内容之前调用 gate-cli cex assetswap order create。
• 如果预览响应已包含带有 amount 的 data.order.to 条目，绝不要使用仅包含比例的目标腿构建创建请求载荷；创建时应使用这些 asset + amount 配对项（以及匹配的 from 腿）。
• 如果 API 返回错误，绝不要伪造订单 ID、预览令牌或成功结果。
• 执行前，汇率和金额均应显示为估算值；最终结算结果具有权威性。
• 不要在用户可见的输出中暴露 API 密钥或机密信息。

---

判断逻辑摘要

条件	操作
用户希望获取适用于投资组合优化的现货资产	仅使用情况 1（gate-cli cex assetswap assets）
用户需要策略选项或限制	使用情况 2（gate-cli cex assetswap config）
用户希望快速估算	使用情况 3a（gate-cli cex assetswap evaluate）
用户准备查看可执行预览	使用情况 3b（gate-cli cex assetswap order preview）
用户已确认预览	使用情况 4（gate-cli cex assetswap order create）
用户询问过去的优化记录	使用情况 5（gate-cli cex assetswap order list）
用户询问某笔订单的进度	使用情况 6（gate-cli cex assetswap order get）
用户希望下单单笔现货订单或使用网格机器人	转出此技能的处理流程
预览失败或已过期	重新预览；不要创建订单

---

报告模板

## Asset allocation optimization

**Goal**: {list | evaluate | preview | order placed | history | detail}

**Eligible assets (summary)**: {N} items, {optional total valuation if API provides}

**Strategy**: {conservative | conviction | market_cap | from API}

**Preview** (if run):
- Key figures: {from API}
- Create legs (if placing order): {`from`/`to` as `asset`+`amount` from `data.order`}
- Risk or slippage notes: {from API}

**Order** (if created):
- Order ID: {id}
- Status: {status}

**History / detail** (if queried):
- {table or bullet list from API}

**Disclaimer**: Digital asset trading involves significant risk and may result in partial or total loss of your investment. Figures are from Gate Exchange APIs; final balances and fees follow account records. No PnL or VIP impact is guaranteed.