1
用户发起请求
商家下单Skill 执行服务流程（搜索、选择、确认）
适用场景
您已开通并接入以下支付宝支付产品：
- 支付宝 电脑网站支付
接入演示视频
1. 整体流程说明
1.1 交互示意图
1.2 详细流程
2
商家SKILL执行下单流程
调用支付宝收单接口，生成支付宝交易信息，并在SKILL脚本中调用支付宝命令压缩成短链
3
引导加载支付宝支付处理技能，使用支付宝进行支付
后续由支付宝支付处理技能接管（检查支付能力开通状态 → 提交支付 → 检查支付结果 → 返回结果）
关键节点4
商家下单Skill 根据支付结果继续履约（发货、开通服务等）
1.3 核心原则
商家下单skill 专注负责业务流程，当选择支付宝作为支付渠道时，支付宝支付处理技能负责支付。
当您的服务流程到达支付环节，且用户选择支付宝作为支付渠道时，只需输出支付宝支付链接并引导模型加载支付宝支付处理技能，支付宝支付处理技能会自动接管后续流程。
2. 如何编写自己的服务 Skill
2.1 Skill 结构要求
您的服务 Skill 需要能够：
- 执行完整的业务流程（搜索、选择、确认等）
- 生成订单并获取支付宝支付链接
- 输出完整的支付宝短链，并引导模型加载支付宝支付处理技能
2.2 支付环节对接规范
示例：电商平台下单流程
提交订单这一步骤涉及与支付宝支付处理技能交互，重点展示这一部分的内容：
### Step 1：检查登录状态
（访问电商网站，检查用户的登录状态，若用户未登录则引导用户登录）
...
### Step 2：搜索商品
(根据用户输入搜索相关商品，返回商品列表供用户选择)
...
### Step 3：SKU 选择
(提取商品规格列表，供用户选择)
...
### Step 4：提交订单
（按照用户选择商品和规格提交订单，选择支付宝作为支付渠道，提交订单）
（将支付宝返回支付链接，通过支付宝命令做支付链接压缩）
（如果压缩结果返回 JSON 包含非空 `paymentLink`，立即加载并调用支付宝支付处理技能）
（无需判断格式，将 JSON 结构中 `paymentLink` 的完整原始值传给该技能作为支付链接，由支付宝支付处理技能提交支付）
（不要自行打开、改写、压缩、截断或展示任何链接。）
（按支付宝支付处理技能指定流程继续处理支付，否则认为失败。）
**决策逻辑**：
```
IF 技能加载调用成功 → 任务完成
ELSE → 输出错误信息 → STOP
```
2.3 输出格式规范
在step 4 获取到支付宝支付短链后，您的skill/工具 应输出类似以下内容：
订单已生成，接下来需要加载支付宝支付处理技能，使用支付宝完成支付
支付宝支付短链特征：
- 前缀为 alipay_*
- 必须逐字符完整保留，禁止截断或修改
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 中完成订单生成，调用支付宝收单接口，获取支付宝支付链接
- 将支付链接调用支付宝命令，生成支付短链
- 引导加载支付宝支付处理技能
对接要点
- 商家下单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
重新授权（如未授权）
按照 支付宝支付服务开通和授权技能 指引完成授权流程
查询支付状态
使用支付宝支付处理技能查询支付状态
遇到错误文案
请及时联系客服获取支付宝技术支持，我们会尽快为您处理
