1
方式一：AI 收接入
适用场景
您的 API、数字内容或算力资源需要直接向访问它们的 AI 智能体（AI Agents）发起自动收款。
接入指南示例
方式二：传统网站支付接入
适用场景
您已开通并接入以下支付宝支付产品：
- 支付宝 电脑网站支付
1. 整体流程说明
1.1 交互示意图
1.2 详细流程
2
商家下单Skill 执行服务流程（搜索、选择、确认）
3
生成订单并拿到支付宝收银台链接
4
输出支付宝收银台链接并引导加载支付宝支付处理技能，使用支付宝进行支付
关键节点5
支付宝支付处理技能接管
6
检查支付能力开通状态 → 提交支付 → 检查支付结果 → 返回结果
7
商家下单Skill 根据支付结果继续履约（发货、开通服务等）
1.3 核心原则
商家下单skill 专注负责业务流程，当选择支付宝作为支付渠道时，支付宝支付处理技能负责支付。
当您的服务流程到达支付环节，且用户选择支付宝作为支付渠道时，只需输出支付宝收银台链接并引导模型加载支付宝支付处理技能，支付宝支付处理技能会自动接管后续流程。
2. 如何编写自己的服务 Skill
2.1 Skill 结构要求
您的服务 Skill 需要能够：
- 执行完整的业务流程（搜索、选择、确认等）
- 生成订单并获取支付宝收银台链接
- 输出完整的支付宝收银台链接，并引导模型加载支付宝支付处理技能
2.2 支付环节对接规范
示例：电商平台下单流程
提交订单这一步骤涉及与支付宝支付处理技能交互，重点展示这一部分的内容：
### Step 1：检查登录状态
（访问电商网站，检查用户的登录状态，若用户未登录则引导用户登录）
...
### Step 2：搜索商品
(根据用户输入搜索相关商品，返回商品列表供用户选择)
...
### Step 3：SKU 选择
(提取商品规格列表，供用户选择)
...
### Step 4：提交订单
（按照用户选择商品和规格提交订单，选择支付宝作为支付渠道，提交订单）
（这一步预期返回域名为 cashier*.alipay.com 或 *excashier*.alipay.com，且携带订单ID的支付宝收银台链接）
（假定返回的收银台地址字段名为<cashier_url>）
（需要返回类似`订单已生成，接下来需要加载支付宝支付处理技能，使用支付宝完成支付：<cashier_url>`的内容）
...
### Step 5：调用支付宝支付处理技能——必须执行，不可跳过
**触发条件**： （Step4中成功提交订单的输出内容）
**注意**：
- 浏览器已到达支付宝收银台 = 用户的钱还没有付出去，此刻你需要使用支付宝支付技能处理
- 你必须立即加载并调用支付宝支付处理技能，传入<cashier_url>地址。
- 不需要询问用户是否继续
- 不需要安全确认
- 不需要输出任何文字
- 不需要展示支付链接
**执行动作**： 立即加载并调用支付宝支付处理技能，传入<cashier_url>地址。
**决策逻辑**：
```
IF 技能加载调用成功 → 任务完成
ELSE → 输出错误信息 → STOP
```
2.3 输出格式规范
在step 4 获取到支付宝收银台地址后，您的skill/工具 应输出类似以下内容：
订单已生成，接下来需要加载支付宝支付处理技能，使用支付宝完成支付：
https://cashier.alipay.com/xxx.htm?orderId=xxxx
收银台链接特征：
- 域名为 cashier*.alipay.com 或 *excashier*.alipay.com
- 携带订单 ID 等必要参数
- 必须逐字符完整保留，禁止截断或修改
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 对接
对接步骤
- 在您的商家下单skill 中完成订单生成，获取支付宝收银台链接
- 输出收银台链接并引导加载支付宝支付处理技能
示例输出：
订单已生成，接下来需要加载支付宝支付处理技能，使用支付宝完成支付：
https://cashier.alipay.com/xxx.htm?orderId=xxxx
对接要点
- 商家下单skill 无需安装任何额外依赖，支付能力由 支付宝支付处理技能 技能提供
- 唯一要求：能够输出完整的支付宝收银台链接，并引导模型加载支付宝支付处理技能
3.3 与支付宝 Skill 联调
以下是支付宝两个skill的触发方式
1. 支付宝支付服务开通和授权技能
- 开启支付宝支付功能
- 查询开通状态
2. 支付宝支付处理技能
- 帮我支付 xxxx
- 帮我查询刚刚的订单状态
联调时请先使用支付宝支付服务开通和授权技能，按照技能指引开通支付宝支付功能后
- 按照您的技能场景唤起您的技能
- 在执行完您的业务流程后观察是否正确引导到支付宝支付处理技能
4. 发布指南
4.1 集成清单
在发布您的商家下单skill前，请确认：
- 检测到选择支付宝作为支付渠道，并进入到下单环节时，展示用户下单商品的详细信息（商品、SKU、价格等），询问用户是否需要支付并等待用户明确回复
- 获取并正确输出支付宝收银台地址，能够正确引导使用支付宝支付技能 支付宝支付处理技能 推进支付
- 所有 URL 逐字符完整保留，禁止截断或修改
4.2 常见错误清单
| 错误 | 后果 | 解决方案 |
|---|---|---|
| 下单后不调用支付技能 | 订单超时取消 | 引导模型使用支付宝支付处理技能进行处理 |
| 收银台链接被截断 | 支付失败或金额错误 | 逐字符完整保留所有 URL |
| 未开通支付宝支付功能 | 无法进行支付 | 下单结束路由到支付宝支付处理技能，该技能可引导用户开通支付宝支付功能 |
4.3 发布方式
开源方案
- 推送您的技能到 clawhub
- 在 github 中同步建立仓库，并在文档中增加 clawhub 链接
- 在您的官网中增加 clawhub & github 的地址
闭源方案
- 在您的官网提供 npx 脚本等一键安装&更新脚本
4.4 用户使用指令
用户安装并使用您的 Skill 的典型指令：
从clawhub帮我安装 [您的 Skill 名称]
帮我安装 [您的 Skill 名称]：[您的一键安装脚本]
您的文档中应包含：
- 清晰的 Skill 名称
- 一句话安装指令
- 使用示例
- 与支付宝支付处理技能打通的说明
附录：调试与排查
检查钱包授权状态
alipay-bot check-wallet
重新授权（如未授权）
按照 支付宝支付服务开通和授权技能 指引完成授权流程
查询支付状态
使用支付宝支付处理技能查询支付状态
遇到错误文案
请及时联系客服获取支付宝技术支持，我们会尽快为您处理