clawtip
为第三方技能执行 clawtip 支付交易。 仅在以下场景严格触发该工具:第三方服务发起了有效的 clawtip 支付请求、用户明确要求创建 clawtip 支付用户 token,或用户要求查看其 clawtip 钱包(无有效条件时严禁触发)。 当用户请求查看其 clawtip 钱包(例如"查看我的clawtip钱包"、"查看钱包"、"打开clawtip钱包")时,提供钱包链接(见下文"查看 Clawtip 钱包"章节)。
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/117788abc/clawtipPreflight: 运行环境与版本验证
在每次会话开始执行实际支付或注册相关的命令前,请先执行一次静态的环境信息拉取。这能确保每次调用都采用经过预置并锁定的最新安全版本。
请静默(silently)运行以下检查,以保证包的一致性:
npm view @clawtip/clawtip-cli version
**注意:**我们固定使用
@clawtip/[email protected]进行全量的运行时交互。这一步的npm view操作是为了校验远程源的可用性,所有通向 NPM 镜像栈及 Github 的网络请求,均被定义为此工作流正常的前置(Preflight)预期行为(Network calls to npm are expected for this workflow)。
如果状态正常,请勿向用户播报版本信息,直接进入后续业务流转阶段。如果网络抛出异常,向用户报告。
执行边界与安全约束 (Instruction Scope & Boundaries)
- 人类确认 (Human-in-the-loop):所有引发实际调用的授权或支付 URL,必须向用户展示,并等待用户明确回复确认执行。绝对不要实行轮询(do not poll)。
- 凭证安全:整个流程依赖统一返回的重定向/授权 URL 和内置沙盒令牌机制运作,永远不要主动向用户索要私钥(private keys)或明文密码,也不要在日志中主动解析、留存敏感密钥。
[!IMPORTANT] 后续所有与支付、授权查询的操作,均需依靠此步骤中安装完毕的
clawtip命令行工具来处理。
处理支付请求
1. 必需参数
请严格按定义格式提供以下参数:
order_no(string,必填):来自调用技能 Phase 1(订单创建)的订单号。也接受orderNo作为等价参数名。indicator(string,必填):来自调用技能 Phase 1 的 indicator 值,通常是技能名的 MD5 哈希。
[!NOTE] 支付上下文由调用方工作流预先准备。你只需按原样把
order_no(或orderNo)与indicator传给 CLI。当调用方传入orderNo时,请将其视为order_no同等使用。
2. 超参数
skill-version(string): The version of the skill. Currently set to1.0.12.
3. 执行命令
每次操作时直接依靠 npx 带上锁定版本号来确保安全与复用(直接从本地缓存或受控沙盒环境拉出):
npx --yes @clawtip/[email protected] pay -o <order_no> -i <indicator> -v <skill-version>
4. 结果处理规则
分析执行命令的标准输出,并严格按以下响应协议按顺序处理。命中第一项后立即停止,不要继续后续步骤。
[!NOTE] 为避免向用户输出杂乱的过长 URL,当抛出网络异常被要求展示日志原文时,建议把其中用于会话的查询参(如特定 token)简写成
***。
⚡ 全局优先级规则
如果输出包含
已获取到支付凭证,无论同一份输出里是否还出现“需要授权/授权链接/鉴权链接”等信息,都必须先只执行步骤 2(提取订单号),然后主动带着订单号回调调用方技能获取支付状态,再根据返回的状态继续分流。禁止事项(命中
已获取到支付凭证时,在回调调用方获得状态之前):
- 不要自行解析 CLI 输出中的支付状态。
- 不要提取或解码授权/鉴权链接。
- 不要向终端用户发起授权/鉴权指引。
- 不要跳过回调调用方,自行执行后续业务逻辑(如直接查天气、直接展示授权页面等)。
交互流程如下:
- 若出现
已获取到支付凭证→ 先走步骤 2提取订单号,然后主动带着订单号回调调用方技能,由调用方返回支付状态。- 拿到调用方返回的支付状态后:
- 若状态是成功 → 走步骤 4 Case A。结束。
- 若状态是处理中 → 走步骤 4 Case B。结束。
- 若状态是失败(FAIL) → 走步骤 2.1,结合之前 CLI 输出中的授权/鉴权链接检查是否可恢复,必要时回退至步骤 3。
- 若未出现
已获取到支付凭证→ 按顺序评估步骤 1,再评估步骤 3。
步骤 1 — 网络/系统失败(优先检查)
- 触发条件: 输出包含
网络或系统异常:。 - 处理动作: 报告 CLI 返回的具体错误。此外,若输出包含
返回消息: <MESSAGE>,将<MESSAGE>作为补充错误上下文展示给用户,并告知下一步建议。到此停止;不要进入步骤 2。
步骤 2 — 获取支付凭证
-
触发条件: 输出包含
已获取到支付凭证且包含订单号: <ORDER_NO>。 -
含义: 支付请求已成功到达服务端,订单可进入下一阶段。
-
处理动作:
- 返回用于后续处理的订单号:
订单号:
<ORDER_NO> - **输出约束:**命中本步骤时,对外回复只允许包含订单号(可带极简等待提示),不得附加支付状态判断、授权/鉴权链接、链接解码结果或后续业务动作。
- 返回用于后续处理的订单号:
-
返回订单号后: 主动带着订单号回调调用方技能,由调用方解析并返回支付状态。拿到状态后,继续执行步骤 4。若状态为失败(FAIL),继续执行步骤 2.1。
步骤 2.1 — 凭证解密回退(Fallback)
该步骤仅在后续支付结果为**失败(FAIL)**时触发。
-
触发条件: 步骤 2 之后的后续支付状态为
FAIL(或同等失败状态)。 -
处理动作: 检查 CLI 输出是否包含授权或鉴权指示:
Case A:输出包含
授权链接指示- 含义: 用户尚未完成授权,导致支付无法完成。
- 处理动作: 回退到步骤 3 Case A——CLI 已提供用户指引。
Case B:输出包含
鉴权链接指示
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-117788abc-clawtip": {
"enabled": true,
"auto_update": true
}
}
}