agent-1yuan-purchase-skill/references/cli-setup.md

CLI 安装与校验

前置条件

• npm 命令可用
• npm config set registry https://registry.npmjs.org/

来源说明

@alipay 是 npm 上由 Ant Group（支付宝母公司）持有的 scoped package 命名空间。源代码托管于 github.com/alipay。

安装流程

1. 用户确认（安装前必须执行）

• 即将安装的外部包：@alipay/agent-payment@1.0.12（支付宝官方 npm 包）
• 安装后会执行 install-cli 命令，将 alipay-bot CLI 工具安装到系统 PATH
• 如用户不同意，终止流程并提示用户可手动安装

2. 完整性校验（必须先于安装执行）

npm view @alipay/agent-payment@1.0.12 dist.integrity

预期值：sha512-WpJNa5rK6pXaLqKbvfHNI6iG0n0/+dX/ETmtWqH2SWeS2hDnpGbjFiLaZDyZHXqPlGNTEzrPWnP4p4Ruy+DOTg==

校验失败处理：如果哈希值不匹配或 npm view 命令失败，立即终止安装，向用户报告"包完整性校验失败，禁止安装"。

3. 安装（仅在校验通过后执行）

npm install @alipay/agent-payment@1.0.12 && npx @alipay/agent-payment@1.0.12 install-cli

必须安装固定版本 @1.0.12，禁止使用 @latest 或其他非锁定版本标签。

4. 验证安装

alipay-bot --version

返回版本号（如 alipay-bot-cli 0.3.19）→ 安装成功

5. Windows 环境特殊处理

如果 alipay-bot 命令不可用，尝试使用完整路径：

# 常见安装位置
~/.openclaw-autoclaw/alipay-bot-cli/bin/alipay-bot.cmd

# 验证
<用户目录>/.openclaw-autoclaw/alipay-bot-cli/bin/alipay-bot.cmd --version

已安装检测

which alipay-bot 2>/dev/null || echo "NOT_FOUND"

返回路径 → 已安装 返回 NOT_FOUND → 未安装，需要执行安装流程