gate-exchange-collateralloan

解析 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 多抵押品借贷技能

通用规则

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

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

技能依赖项

使用的 gate-cli 命令

查询操作（只读）

• gate-cli cex mcl current-rate
• gate-cli cex mcl fix-rate
• gate-cli cex mcl ltv
• gate-cli cex mcl order
• gate-cli cex mcl orders
• gate-cli cex mcl records
• gate-cli cex mcl repay-records
• gate-cli cex mcl quota
• gate-cli cex mcl collateral

执行操作（写入）

• gate-cli cex mcl create
• gate-cli cex mcl repay

身份验证

• **交互式文件设置：**当主机上未同时设置 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；绝不要要求用户在聊天中粘贴密钥。
• **权限：**Mcl: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，然后执行本技能的抵押借贷工作流。

• SKILL.md 负责路由和产品限制。
• references/gate-cli.md 是权威的 gate-cli 执行规范，涵盖额度 / LTV 预检查、确认关卡和操作后验证。

触发条件

当用户询问多抵押品借贷操作时，此技能将激活。根据路由规则（案例 1–7）对意图进行分类。触发短语包括：“抵押借贷”、“当前借贷”、“固定利率借贷”、“还款”、“追加抵押品”、“赎回抵押品”，或其他语言中的同义表达。

工作流

步骤 1：判断意图

使用路由规则（案例 1–7）识别用户意图。如果缺少必需输入（order_id、币种、金额、固定期限），请先提出澄清问题，再继续操作。

步骤 2：只读请求（利率、LTV、额度、订单）

用户询问利率、LTV、额度、订单列表或订单详情时，调用相应的 MCP 工具。

调用 gate-cli cex mcl quota 时传入：

• type：collateral 或 borrow
• currency：以逗号分隔（借款时只能指定一种币种）

调用 gate-cli cex mcl ltv 时传入：

• （无参数）

调用 gate-cli cex mcl fix-rate 时传入：

• （无参数）

调用 gate-cli cex mcl current-rate 时传入：

• currencies：以逗号分隔的币种列表

调用 gate-cli cex mcl orders 时传入：

• page、limit（可选）
• sort（可选）：time_desc、ltv_asc、ltv_desc
• order_type（可选）：current 或 fixed

调用 gate-cli cex mcl order 时传入：

• order_id

需要提取的关键数据：

• LTV 阈值、固定/当前利率、额度行、order_id、订单状态、抵押品和借款详情

步骤 3：创建贷款（当前或固定）

如果是当前贷款：

1. 构建草案（抵押品列表 + 借款币种/金额）。
2. 请求用户确认。
3. 调用 gate-cli cex mcl create，传入 order：JSON 字符串（borrow_currency、borrow_amount、collateral_currencies、order_type: current）。 如果是固定贷款：
4. 调用 gate-cli cex mcl fix-rate（返回一个列表）；按 borrow_currency 进行筛选；取 rate_7d 或 rate_30d 作为 fixed_rate（小时利率；直接传入，不要换算，也不要标注为年利率或日利率）。
5. 使用 fixed_type 和 fixed_rate 构建草案（如向用户展示，请说明是小时利率）。
6. 请求用户确认。
7. 调用 gate-cli cex mcl create，传入 order：包含 order_type: fixed、fixed_type 7d/30d、fixed_rate 的 JSON。

步骤 4：还款

构建草案并请求用户确认，然后调用 gate-cli cex mcl repay，传入：

• repay_loan：包含 order_id 和 repay_items [{ currency, amount, repaid_all }] 的 JSON 字符串

步骤 5：追加或赎回抵押品

构建草案并请求用户确认，然后调用 gate-cli cex mcl collateral，传入：

• collateral_adjust：包含 order_id、type（append | redeem）、collaterals [{ currency, amount }] 的 JSON 字符串

判断逻辑摘要

• 根据关键词和必需输入判断案例（创建贷款 / 还款 / 追加 / 赎回 / 列表）。
• 固定贷款需要查询 fix_rate；如果无法获取，则停止操作并告知用户。
• 所有写入操作都必须在调用 MCP 前获得确认。
• 身份验证失败（401/403）时，提示用户配置 API 密钥。

报告模板

请求确认时： 草案：

• 类型：{current|fixed|repay|append|redeem}
• 订单 ID：{order_id if applicable}
• 借款：{borrow_amount} {borrow_currency}
• 抵押品：{collateral_amounts}
• 固定期限/利率：{fixed_type} / {fixed_rate}（小时利率）

请确认后继续。

成功时：

• 操作摘要及关键标识符（order_id、金额）。 失败时：
• 错误消息及后续操作指引（例如，检查币种/金额/LTV）。

前提条件

• MCP 依赖项：需要安装 gate-mcp。
• 身份验证：订单列表、详情、还款、抵押品、额度和记录功能需要 API 密钥；LTV、fix rate 和 current rate 为公开信息，无需密钥。
• 免责声明：贷款和 LTV 信息仅供参考，不构成投资建议。借款前请了解产品条款和强平风险。

可用的 MCP 工具

工具	身份验证	描述	参考
gate-cli cex mcl fix-rate	否	7 天／30 天固定利率（列表）	references/mcl-mcp-tools.md
gate-cli cex mcl ltv	否	LTV 阈值	references/mcl-mcp-tools.md
gate-cli cex mcl current-rate	否	当前利率	references/mcl-mcp-tools.md
gate-cli cex mcl quota	是	借款／抵押品额度	references/mcl-mcp-tools.md
gate-cli cex mcl create	是	创建贷款（order JSON）	references/mcl-mcp-tools.md
gate-cli cex mcl orders	是	列出订单	references/mcl-mcp-tools.md
gate-cli cex mcl order	是	订单详情	references/mcl-mcp-tools.md
gate-cli cex mcl repay	是	还款（repay_loan JSON）	references/mcl-mcp-tools.md
gate-cli cex mcl collateral	是	添加／赎回抵押品（collateral_adjust JSON）	references/mcl-mcp-tools.md
gate-cli cex mcl repay-records	是	还款历史	references/mcl-mcp-tools.md
gate-cli cex mcl records	是	抵押品历史	references/mcl-mcp-tools.md

路由规则

情况	用户意图	关键词信号	操作
1	创建活期贷款	"current loan", "pledge... borrow... (current)"	参见 references/scenarios.md 场景 1
2	创建定期贷款	"fixed loan", "borrow... for 7/30 days"	参见 references/scenarios.md 场景 2
3	还款	"repay", "repay order..."	参见 references/scenarios.md 场景 3
4	添加抵押品	"add collateral", "add margin"	参见 references/scenarios.md 场景 4
5	赎回抵押品	"redeem collateral", "reduce margin"	参见 references/scenarios.md 场景 5
6	列出订单／订单详情	"loan orders", "order detail", "my orders"	gate-cli cex mcl orders / gate-cli cex mcl order — 面向用户的回复中绝不包含任何时间／日期字段（见下文「展示」）
7	身份验证失败（401/403）	MCP 返回 401/403	不要泄露密钥；提示用户配置 Gate CEX API Key（多抵押贷款）。

执行

1. 根据上方的「路由规则」表识别用户意图。
2. 对于情况 1–5：阅读 references/scenarios.md 中对应的场景，并遵循工作流（先展示订单草稿，再仅在用户确认后调用 MCP）。
3. 对于情况 6：按需调用列表或详情工具；只读操作无需确认。绝不显示 borrow_time、maturity、due date、operate_time、create_time、repay_time、Unix 时间戳或任何其他与时间相关的字段，即使用户询问日期／时间也不例外；建议用户查看 Gate 应用或网站以了解时间详情。
4. 对于情况 7：不要泄露 API 密钥或原始错误；提示用户在 MCP 中设置具有多抵押贷款权限的 Gate CEX API Key。
5. 如果用户意图不明确（例如缺少 order_id、currency 或 amount），请先提出澄清问题，再进行路由。

领域知识

核心概念

• 活期贷款：灵活贷款。通过 gate-cli cex mcl create 创建，并使用 order JSON：order_type: current。
• 定期贷款：7 天／30 天。order JSON 必须包含 order_type: fixed、fixed_type：7d 或 30d（小写），以及 fixed_rate：来自 gate-cli cex mcl fix-rate 的小时利率（针对对应的 borrow_currency 使用 rate_7d 或 rate_30d；按原值传入，不要描述为年利率或日利率）。缺少固定贷款字段可能会导致 INVALID_PARAM_VALUE。
• 还款：使用 repay_loan JSON 调用 gate-cli cex mcl repay。
• 添加抵押品：使用 gate-cli cex mcl collateral，并在 collateral_adjust 中设置 type: append。
• 赎回抵押品：使用同一工具，并设置 type: redeem。
• LTV：gate-cli cex mcl ltv — init_ltv、alert_ltv、liquidate_ltv。

创建借款流程（案例 1 和 2）

1. 解析抵押品、借款币种/金额；固定期限：7 天 → 7d，30 天 → 30d。
2. 浮动：可选调用 gate-cli cex mcl quota 或当前利率工具。确认后：使用 order JSON 调用 gate-cli cex mcl create。
3. 固定：调用 gate-cli cex mcl fix-rate；按 borrow_currency 筛选列表；如果列表为空或没有匹配项，则停止并告知用户；否则将 fixed_rate 设为 rate_7d 或 rate_30d（小时利率；按原值传入 order JSON；不得描述为年利率或日利率）。确认后：使用包含固定字段的 order JSON。

还款流程（案例 3）

1. 解析 order_id 和还款金额（或全额还款）。
2. 展示草稿；确认后：使用 repay_loan JSON 调用 gate-cli cex mcl repay。

增加/赎回抵押品流程（案例 4 和 5）

1. 解析 order_id 和抵押品金额/币种。
2. 展示草稿；确认后：使用 collateral_adjust JSON 调用 gate-cli cex mcl collateral。

展示——订单列表/订单详情（案例 6）

当用户要求查看我的抵押借款订单或订单详情时：

• 不显示时间字段：不得输出任何时间或日期信息——省略 MCP 中所有时间戳类字段（例如 borrow_time、到期时间、还款期限、operate_time、create_time、repay_time、日历日期、作为日期表示的 Unix 秒数）。不得转述根据这些字段计算出的相对时间（例如“3 天后到期”）。
• 回复中允许显示：order_id、status、借款部分（币种、剩余本金/利息）、抵押品部分（币种、金额）、当前 LTV（如果有）、fixed_type 7d/30d（仅显示期限标签，不得包含日历日期）。
• 如果用户明确询问日期/到期时间：回复说明此处不显示时间信息，请用户打开 Gate（应用/网页）查看完整订单计划——仍不得将 API 时间字段粘贴到聊天中。

安全规则

• 写操作（gate-cli cex mcl create、gate-cli cex mcl repay、gate-cli cex mcl collateral）：执行前始终需要用户明确确认并展示订单草稿。
• 不提供投资建议：展示 LTV/利率；由用户自行决定。
• 敏感数据：绝不泄露 API 密钥或原始内部错误。
• 金额：拒绝非正数；验证还款/抵押操作的 order_id。
• 订单视图：在向用户回复订单列表/详情时，绝不显示时间列、日期或时间戳字段。

错误处理

条件	响应
401/403	"Please configure your Gate CEX API Key in MCP with multi-collateral loan permission."
gate-cli cex mcl create 失败	检查 order JSON：借款字段；固定期限需包含 fixed_type 7d/30d，以及来自 fix_rate 工具的 fixed_rate。
错误的 fixed_type	必须为 7d 或 30d，且使用小写。
fix rate 为空（固定）	"Fixed rate temporarily unavailable; try later or use current loan."
还款/操作失败	检查 JSON 载荷中的 order_id、币种和金额。
未找到订单	"Order not found." / "No loan orders."

提示词示例和场景

提示词示例及预期行为（创建浮动/固定借款、还款、增加抵押品、赎回抵押品）请参阅 references/scenarios.md。