传统供给Skill变现

我之前在APP、小程序、网站经营，现在我想要让我的服务可以被Agent调用并收款。

适用场景

您已开通并接入以下支付宝支付产品：

• 支付宝 电脑网站支付

接入演示视频

---

1. 整体流程说明

1.1 交互流程

sequenceDiagram
    actor User as 用户

    box rgb(235, 235, 255) 智能体侧
        participant OC as OpenClaw/Hermes
        participant OrderSkill as 商家下单 skill
        participant PaySkill as 支付宝支付处理 skill
    end

    box rgb(235, 235, 255) 服务端
        participant MerchantServer as 商户服务端
        participant Alipay as 支付宝
    end

    User->>OC: 1. 请求购买商户服务
    OC->>OrderSkill: 2. 加载并调用商家下单 skill

    OrderSkill->>MerchantServer: 3. 选择商品并下单支付
    MerchantServer->>Alipay: 4. 发起支付宝收单
    Alipay-->>MerchantServer: 返回支付单
    MerchantServer-->>OrderSkill: 返回订单信息，包含支付宝支付链接

    OrderSkill->>PaySkill: 唤起支付宝技能命令，压缩支付链接
    PaySkill-->>OrderSkill: 返回短链交易信息

    OrderSkill->>OrderSkill: 3. 完成商户处理逻辑，用支付宝推进支付
    OrderSkill-->>OC: 4. 提供支付宝短链交易信息，引导用户加载支付宝支付处理 skill

    OC->>PaySkill: 5. 唤起支付宝支付处理 skill
    PaySkill->>PaySkill: 6. 推进付款流程
    PaySkill-->>Alipay: 基于交易信息进行支付

1.2 详细流程

1. 用户发起请求 商家下单Skill 执行服务流程（搜索、选择、确认）

2. 商家SKILL执行下单流程 调用支付宝收单接口，生成支付宝交易信息，并在SKILL脚本中调用支付宝命令压缩成短链

3. 引导加载支付宝支付处理技能，使用支付宝进行支付 关键节点 后续由支付宝支付处理技能接管（检查支付能力开通状态 → 提交支付 → 检查支付结果 → 返回结果）

4. 商家下单Skill 根据支付结果继续履约（发货、开通服务等）

1.3 核心原则

商家下单skill 专注负责业务流程，当选择支付宝作为支付渠道时，支付宝支付处理技能负责支付。

当您的服务流程到达支付环节，且用户选择支付宝作为支付渠道时，只需输出支付宝支付链接并引导模型加载支付宝支付处理技能，支付宝支付处理技能会自动接管后续流程。

---

2. 如何编写自己的服务 Skill

2.1 Skill 结构要求

您的服务 Skill 需要能够：

1. 执行完整的业务流程（搜索、选择、确认等）
2. 生成订单并获取支付宝支付链接
3. 输出完整的支付宝短链，并引导模型加载支付宝支付处理技能

2.2 支付环节对接规范

示例：电商平台下单流程

检查登录状态 → 搜索商品 → SKU 选择 → 提交订单 → 调用支付宝技能

提交订单 这一步骤涉及与支付宝支付处理技能交互，重点展示这一部分的内容：

### Step 1：检查登录状态
（访问电商网站，检查用户的登录状态，若用户未登录则引导用户登录）
...

### Step 2：搜索商品
(根据用户输入搜索相关商品，返回商品列表供用户选择)
...

### Step 3：SKU 选择
(提取商品规格列表，供用户选择)
...

### Step 4：提交订单
（按照用户选择商品和规格提交订单，选择支付宝作为支付渠道，提交订单）
（将支付宝返回支付链接，通过支付宝命令做支付链接压缩）
（如果压缩结果返回 JSON 包含非空 `paymentLink`，立即加载并调用支付宝支付处理技能）
（无需判断格式，将 JSON 结构中 `paymentLink` 的完整原始值传给该技能作为支付链接，由支付宝支付处理技能提交支付）
（不要自行打开、改写、压缩、截断或展示任何链接。）
（按支付宝支付处理技能指定流程继续处理支付，否则认为失败。）

**决策逻辑**：
IF 技能加载调用成功 → 任务完成
ELSE → 输出错误信息 → STOP

2.3 输出格式规范

在step 4 获取到支付宝支付短链后，您的skill/工具 应输出类似以下内容：

订单已生成，接下来需要加载支付宝支付处理技能，使用支付宝完成支付

支付宝支付短链特征：

• 前缀为 alipay_*
• 必须逐字符完整保留，禁止截断或修改

2.4 示例demo下载

请访问支付宝电脑网站支付 Demo - 运势预测 (Node.js) 获取示例代码和配套上翻skill。

---

3. 联调测试

3.1 环境准备

前置依赖

软件	版本
OS	macOS、Linux（CentOS、Ubuntu）
Node.js	v22.*+
npm	10.*+
OpenClaw	最佳体验：2026.3.28+

Skill 安装

安装命令：

npx -y @alipay/agent-payment@latest install

提示信息示例

帮我装一下支付宝的 Skill，安装命令是 npx -y @alipay/agent-payment@latest install

3.2 与支付宝 Skill 对接

对接步骤

1. 在您的商家下单skill 中完成订单生成，调用支付宝收单接口，获取支付宝支付链接
2. 将支付链接调用支付宝命令，生成支付短链
3. 引导加载支付宝支付处理技能

对接要点

• 商家下单skill 无需安装任何额外依赖，支付能力由 支付宝支付处理技能 技能提供
• 唯一要求：能够输出完整的支付宝短链，并引导模型加载支付宝支付处理技能

3.3 与支付宝 Skill 联调

以下是支付宝两个skill的触发方式

1. 支付宝支付服务开通和授权技能

• 开启支付宝支付功能
• 查询开通状态

2. 支付宝支付处理技能

• 帮我支付 xxxx
• 帮我查询刚刚的订单状态

联调时请先使用支付宝支付服务开通和授权技能，按照技能指引开通支付宝支付功能后：

• 按照您的技能场景唤起您的技能
• 在执行完您的业务流程后观察是否正确引导到支付宝支付处理技能

---

4. 发布指南

4.1 集成清单

在发布您的商家下单skill前，请确认：

• 检测到选择支付宝作为支付渠道，并进入到下单环节时，展示用户下单商品的详细信息（商品、SKU、价格等），询问用户是否需要支付并等待用户明确回复
• 获取并正确输出支付宝支付链接，能够正确引导使用支付宝支付技能 支付宝支付处理技能 推进支付
• 所有 URL 逐字符完整保留，禁止截断或修改

4.2 常见错误清单

错误	后果	解决方案
下单后不调用支付技能	订单超时取消	引导模型使用支付宝支付处理技能进行处理
支付宝支付链接被截断	支付失败或金额错误	逐字符完整保留所有 URL
未开通支付宝支付功能	无法进行支付	下单结束路由到支付宝支付处理技能，该技能可引导用户开通支付宝支付功能

4.3 发布方式

开源方案

1. 推送您的技能到 clawhub
2. 在 github 中同步建立仓库，并在文档中增加 clawhub 链接
3. 在您的官网中增加 clawhub & github 的地址

闭源方案

1. 在您的官网提供 npx 脚本等一键安装&更新脚本

4.4 用户使用指令

用户安装并使用您的 Skill 的典型指令：

从clawhub帮我安装 [您的 Skill 名称]

或

帮我安装 [您的 Skill 名称]：[您的一键安装脚本]

您的文档中应包含：

• 清晰的 Skill 名称
• 一句话安装指令
• 使用示例
• 与支付宝支付处理技能打通的说明