gate-exchange-vipfee

解析 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 VIP 与费率查询助手

通用规则

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

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

技能依赖项

使用的 gate-cli 命令

查询操作（只读）

• gate-cli cex account detail
• gate-cli cex wallet market trade-fee

身份验证

• 交互式文件配置： 如果主机上未同时设置 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。绝不要要求用户在聊天中粘贴密钥。
• 权限： Account:Read、Wallet:Read
• 门户： 在聊天之外创建或轮换密钥：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，然后执行此技能的 VIP／费率查询工作流。

• SKILL.md 负责意图路由和结果呈现规则。
• references/gate-cli.md 是检索账户／费率数据和安全输出行为的权威 gate-cli 执行规范。

快速开始

以下是一些最常见的提示词，可帮助你快速开始：

1. 查询 VIP 等级

我的 VIP 等级是多少？

2. 查询交易费率

显示现货和期货交易费率。

3. 同时查询 VIP 等级和费率

查询我的 VIP 等级和交易费率。

领域知识

按领域划分的工具映射

分组	工具调用
账户／VIP 等级	gate-cli cex account detail
交易费率	gate-cli cex wallet market trade-fee

核心概念

• VIP 等级：Gate 根据交易量和资产持有量分配 VIP 等级（VIP 0 – VIP 16）。VIP 等级越高，解锁的费率越低。
• 现货手续费：适用于现货交易对的 Maker/Taker 费率。
• 合约手续费：适用于期货/合约交易的 Maker/Taker 费率，并根据结算货币（BTC、USDT、USD）区分。
• gate-cli cex wallet market trade-fee 工具会在一次响应中返回现货和合约费率。使用 settle 参数查询特定结算货币对应的合约手续费。

API 行为说明

• 账户级定价：Gate 手续费率由用户的 VIP 等级决定。currency_pair 参数不会改变返回的费率值——所有交易对共用相同的账户级费率。
• settle 参数的作用范围：settle 参数只影响合约手续费字段（futuresMakerFee / futuresTakerFee）。无论 settle 的值是什么，现货手续费（makerFee / takerFee）都保持不变。
• 无效 currency_pair 的处理：对于不存在的交易对，API 不会返回错误，而是静默返回默认的账户级手续费。不要将成功响应视为交易对存在的确认。

工作流

当用户询问 VIP 等级或交易手续费时，请按以下顺序执行。

步骤 1：识别查询类型

将请求归类为以下类型之一：

1. VIP 等级查询——用户想了解当前的 VIP 等级
2. 费率查询——用户想了解现货和/或合约交易费率
3. 综合查询——用户想同时了解 VIP 等级和手续费信息

需要提取的关键数据：

• query_type："vip"、"fee" 或 "combined"
• currency_pair（可选）：查询手续费时指定的交易对
• settle（可选）：合约结算货币（BTC / USDT / USD）

步骤 2：查询 VIP 等级（如有需要）

如果 query_type 为 "vip" 或 "combined"：

调用 gate-cli cex account detail：

• 无需参数

需要提取的关键数据：

• vip_level：用户当前的 VIP 等级（例如，VIP 0、VIP 1 等）

步骤 3：查询交易费率（如有需要）

如果 query_type 为 "fee" 或 "combined"：

调用 gate-cli cex wallet market trade-fee：

• currency_pair（可选）：指定交易对（注意：费率为账户级费率，不会因交易对而异）
• settle（可选）：合约结算货币——只影响合约手续费字段

需要提取的关键数据：

• maker_fee_rate：现货 Maker 手续费率
• taker_fee_rate：现货 Taker 手续费率
• futures_maker_fee_rate：合约 Maker 手续费率
• futures_taker_fee_rate：合约 Taker 手续费率

步骤 4：返回结果

按照报告模板整理响应。API（gate-cli cex wallet market trade-fee）始终会返回完整的手续费结构（现货 + 合约 + 交割）。根据用户的原始意图筛选输出：

• 如果用户只询问现货手续费 → 只显示 makerFee / takerFee
• 如果用户只询问期货/合约手续费 → 只显示 futuresMakerFee / futuresTakerFee
• 如果用户笼统地询问交易手续费 → 同时显示现货和合约手续费
• 如果用户只询问VIP 等级 → 只显示 VIP 等级，不显示手续费数据
• 如果用户指定了 currency_pair → 在响应中附加说明："注意：API 返回的是账户级费率。显示的手续费适用于所有交易对；如果您指定的交易对不存在，结果仍会反映您的默认账户费率。"

需要提取的关键数据：

• VIP 等级（如有查询）
• 现货 Maker/Taker 费率（如有查询）
• 合约 Maker/Taker 费率（如有查询）

判断逻辑摘要

条件	操作
用户仅询问 VIP 等级	调用 gate-cli cex account detail，返回 VIP 等级
用户仅询问交易手续费	调用 gate-cli cex wallet market trade-fee，返回现货和期货费率
用户同时询问 VIP 等级和手续费	调用两个工具，返回合并结果
用户指定交易对	将 currency_pair 参数传递给 gate-cli cex wallet market trade-fee
用户指定期货结算币种	将 settle 参数传递给 gate-cli cex wallet market trade-fee
用户仅询问现货手续费	调用 gate-cli cex wallet market trade-fee，仅返回现货手续费部分
用户仅询问期货／合约手续费	使用 settle 参数调用 gate-cli cex wallet market trade-fee，仅返回期货手续费部分
用户指定 currency_pair	附加免责声明，说明 API 不会验证交易对；返回的手续费是账户级默认值，且该交易对可能不存在
API 返回错误或空数据	告知用户问题所在，并建议检查账户身份验证

报告模板

## Query Result

{vip_section}

{fee_section}

VIP 部分（查询 VIP 时）：

### VIP Tier

| Item | Value |
|------|-------|
| VIP Level | {vip_level} |

手续费部分（查询手续费时）：

### Trading Fee Rates

| Category | Maker Fee | Taker Fee |
|----------|-----------|-----------|
| Spot | {spot_maker_fee} | {spot_taker_fee} |
| Futures | {futures_maker_fee} | {futures_taker_fee} |

合并示例输出：

## Query Result

### VIP Tier

| Item | Value |
|------|-------|
| VIP Level | VIP 1 |

### Trading Fee Rates

| Category | Maker Fee | Taker Fee |
|----------|-----------|-----------|
| Spot | 0.1% | 0.1% |
| Futures (USDT) | 0.015% | 0.05% |

错误处理

错误类型	常见原因	处理策略
身份验证失败	API 密钥无效或已过期	告知用户检查 MCP 配置和 API 密钥有效性
响应为空	无法获取账户数据	告知用户查询未返回数据，并建议重试
网络错误	MCP 连接问题	建议用户检查 MCP 服务连通性

安全规则

• 此 Skill 为只读，不会执行任何交易或账户修改操作。
• 由于所有操作均为查询，因此无需用户确认。
• 回复中绝不泄露原始 API 密钥或敏感身份验证信息。