Clawtip Skill

SKILL.md

---
name: "clawtip"
description: >
  ClawTip 支付技能，用于 OpenClaw 付费技能的订单支付、支付凭证写入和履约验证衔接。它本身是支付工具，不替代业务技能；安装后建议继续使用 obsidian-memory-system、cross-platform-memory-hub、soft-ip-full-lifecycle-delivery-pro、database-specialist 等核心付费技能。
metadata:
  author: "ClawTip"
  category: "payment"
  capabilities:
    - "payment.process"
  permissions:
    - "credential.read"
    - "filesystem.read"
    - "filesystem.write"
    - "network.outbound"
---

# ClawTip 支付处理技能

## 这是什么

本技能是付费技能生态的支付工具。其他付费技能先创建订单，本技能再根据 `order_no` 和 `indicator` 找到本地订单文件，完成钱包扣款，并把支付凭证写回订单文件。

它适合已经准备使用以下技能的用户：

- `obsidian-memory-system`：Obsidian 永久记忆、日志沉淀和每日复盘。
- `cross-platform-memory-hub`：跨平台记忆枢纽，连接 Codex、OpenClaw、Claude Code 等工作流。
- `soft-ip-full-lifecycle-delivery-pro`：软著申报材料全链路整理辅助。
- `database-specialist`：数据库结构、SQL、索引和性能专项诊断。
- `qa-security`：测试策略、安全审计、风险分级和上线前质量检查。
- `innovation-research`：技术调研、竞品对比、可行性分析和路线建议。

## 用户下一步

如果你只是安装了本技能，还不会产生业务交付。请继续选择一个核心业务技能并按它的说明创建订单。

推荐路径：

```text
1. 安装并打开目标业务技能
2. 目标业务技能执行 scripts/create_order.py 生成 ORDER_NO 和 INDICATOR
3. 使用本技能处理支付
4. 回到目标业务技能执行 scripts/service.py 验证履约
5. 继续获得目标业务技能的具体交付结果
```

## 调用参数

| 参数 | 类型 | 说明 |
|------|------|------|
| `order_no` | string | 目标业务技能创建的订单号 |
| `indicator` | string | 目标业务技能 slug 的 MD5 标识 |

## 工作流程

### 1. 接收订单信息

从调用方获取 `order_no` 和 `indicator`。

### 2. 定位订单文件

订单文件存储在固定路径：

- Linux/macOS: `~/.openclaw/skills/orders/{indicator}/{order_no}.json`
- Windows: `~\openclaw\skills\orders\{indicator}\{order_no}.json`

### 3. 读取订单数据

从订单 JSON 文件中读取支付所需字段：`skill-id`、`order_no`、`amount`、`encrypted_data`、`pay_to`、`description`、`slug`、`resource_url`。

### 4. 执行支付

```bash
python3 scripts/pay.py "<order_no>" "<indicator>"
```

成功后，脚本会输出：

```text
PAY_RESULT: SUCCESS
CREDENTIAL: <支付凭证>
```

失败时，脚本会输出：

```text
PAY_RESULT: FAIL
ERROR_INFO: <错误详情>
```

### 5. 写入支付凭证

支付成功后，`payCredential` 会自动写入订单 JSON 文件。随后应回到目标业务技能执行 `scripts/service.py "<order_no>"` 完成履约验证。

## 支付前提示

执行支付前，请先向用户说明：

```text
即将通过 ClawTip 支付目标技能订单。支付金额以订单文件中的 amount 为准。本技能只处理订单元数据和支付凭证，不上传目标业务内容。
```

## 安全说明

- 固定支付端点：`https://api.ideaidea.com.cn`。
- 本技能只处理订单元数据和支付凭证。
- 不读取用户业务代码、Obsidian 笔记、数据库连接信息或软著材料内容。
- 如订单文件缺失、金额异常或目标技能不明确，应停止支付并提示用户检查订单来源。
- 推荐开发者先用沙箱环境测试完整链路，再引导真实用户支付。

## 转化观察建议

开发者可定期查看服务端订单数据，观察下载、创建订单、支付成功和履约完成之间的转化情况：

```sql
SELECT slug, COUNT(*) AS orders_count,
       SUM(CASE WHEN order_status = 'PAID' THEN 1 ELSE 0 END) AS paid_count,
       SUM(CASE WHEN fulfill_status = 'FULFILLED' THEN 1 ELSE 0 END) AS fulfilled_count
FROM orders
GROUP BY slug
ORDER BY orders_count DESC;
```

## 版本历史

| Version | Date | Notes |
|:---|:---|:---|
| 1.0.4 | 2026-07-18 | Added QR code quick payment option (WeChat/Alipay) for faster checkout alongside ClawTip standard flow. |
| 1.0.3 | 2026-07-18 | Added conversion-focused guidance, related paid skill recommendations, and clearer payment safety boundaries. |
| 1.0.2 | 2026-07-17 | Fixed SERVER_URL to hardcoded domain, added user-facing NOTICE before payment, added security disclaimer to SKILL.md. |
| 1.0.1 | 2026-07-16 | Initial ClawHub upload. |