# CLI 安装与校验

## 前置条件

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

## 来源说明

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

## 安装流程

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

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

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

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

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

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

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

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

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

### 4. 验证安装

```bash
alipay-bot --version
```

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

### 5. Windows 环境特殊处理

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

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

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

## 已安装检测

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

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