用途:在 Gate 交易所查询和查看用户的优惠券/体验金账户,支持六类场景:列出可用优惠券、按券类型搜索、查看已过期或已使用记录、查看单张券完整详情、阅读使用规则、追溯券的获取来源。
主要能力:核心命令为只读的 gate-cli cex coupon list(分页,可按类型/状态筛选,参数含 expired、limit、last_id、expire_time、order_by、coupon_type、is_task_coupon)和 gate-cli cex coupon detail(需 coupon_type 与 detail_id,任务券需 is_task_coupon=1)。技能内含券类型映射表(如 position_voucher 中文为“仓位体验券”,contract_bonus 为“合约体验金”,两者不可混淆)与状态说明(如 NOT_ACTIVE、ACTIVATED、EXPIRED、USED 等),按用户意图路由到 list-coupons 或 coupon-detail 参考文档执行。
使用方式:需已安装 gate-cli,可用技能目录下 sh ./setup.sh 安装,并可将 $HOME/.openclaw/skills/bin 加入 PATH。认证需 API Key,权限为 Coupon:Read;当主机已同时设置 GATE_API_KEY 与 GATE_API_SECRET 时无需运行 gate-cli config init,否则运行该命令完成配置,切勿要求用户在对话中粘贴密钥。使用前须阅读并遵守运行时规则与 references/gate-cli.md。
适用场景:用户询问“我有哪些券”“有没有返佣券”“查看该券详情或规则”“券从哪来”“已用/已过期券”等。
限制:所有操作均为只读查询,不涉及写入;只能使用本技能明确列出的命令;不得推断或猜测券 ID,须先从列表接口获取;券不存在、类型无效或无匹配结果时按对应提示处理。价格、收费与具体平台效果类信息资料未提供。