---
url: /v6.2/cli-install.md
---
# HENGSHI CLI 安装与升级

## 获取方式

HENGSHI CLI 现已提供公开下载，适用于 Linux / macOS / Windows。

* 安装脚本（Linux / macOS）：`https://download.hengshi.com/cli/install.sh`
* 安装脚本（Windows PowerShell）：`https://download.hengshi.com/cli/install.ps1`
* GitHub Releases（手动下载发布包与 Release Note）：`https://github.com/hengshi/cli/releases`

安装与后续升级共用这组 installer 入口；如果你需要手动下载某个固定版本，请使用 GitHub Releases，不要直接拼接 `download.hengshi.com` 的版本路径。

> \[!NOTE]
> 从 **2.0.0** 开始，公开命令入口为 `hbi`，环境变量前缀为 `HBI_*`。为避免混淆，本页不展开旧命名空间的兼容细节；如你的环境仍在使用旧命令/变量，请以实际安装包与升级脚本输出为准。

## 推荐安装方式

### 方式一：使用官方安装脚本

Linux / macOS：

```bash
curl -fsSL https://download.hengshi.com/cli/install.sh | sh
```

Windows PowerShell：

```powershell
irm https://download.hengshi.com/cli/install.ps1 | iex
```

如果你希望在安装 CLI 的同时安装官方 skills，可以直接带上 installer flag：

```bash
curl -fsSL https://download.hengshi.com/cli/install.sh | sh -s -- --with-skills
curl -fsSL https://download.hengshi.com/cli/install.sh | sh -s -- --with-skills --agent openclaw
curl -fsSL https://download.hengshi.com/cli/install.sh | sh -s -- --with-skills --agent claude-code --agent github-copilot
```

Windows PowerShell：

```powershell
& ([scriptblock]::Create((irm https://download.hengshi.com/cli/install.ps1))) -WithSkills -Agent openclaw
```

不指定 `--agent` 时，installer 会按 bundled `supported-agents.tsv` 自动探测本机已存在的 Agent 配置目录；显式指定 `--agent` 时，则直接写入对应 Agent 的全局 skills 目录。

### 方式二：通过 GitHub Releases 手动下载发布包

如果你需要固定版本、离线分发，或希望把二进制纳入现有软件仓库，请直接从 GitHub Releases 下载对应版本的发布包：

```text
https://github.com/hengshi/cli/releases
```

对应 release 页面中可以下载：

* 对应平台的二进制压缩包
* `checksums.txt`
* Release Note

## 安装后验证

至少完成下面三步：

```bash
hbi --version
hbi --help
hbi auth status
```

如果 `hbi --version` 可以正常返回，而 `auth status` 只提示尚未登录，说明 CLI 本身已安装成功。接下来通常先显式选择目标 host，再完成认证：

```bash
export HBI_HOST="<你的-hengshi-sense-实例>"
hbi auth login --device-login
```

如果是自动化环境，优先使用显式的 `HBI_HOST` + `HBI_CLIENT_ID` + `HBI_CLIENT_SECRET`。当前 CLI 不再依赖系统钥匙串；如果当前运行时完全不想保存可续期凭据，可以用一次性的 `HBI_TOKEN` / `--token`。完整的 host / auth 决策表见 [认证与连接](cli-auth.md)。

## 升级说明

升级不需要单独的“升级下载地址”。如果当前 CLI 来自官方 installer，优先直接使用内置升级命令：

* **检查是否有新版本**：`hbi update --check`
* **升级到最新公开版本**：`hbi update`
* **升级 CLI 并同步 bundled skills**：`hbi update --with-skills`
* **升级或切到指定公开版本**：`hbi update --version <version>`
* **只刷新官方 skills**：`hbi update --version <current-version> --with-skills`

```bash
hbi update --check
hbi update
hbi update --with-skills
```

`hbi update --check` 不依赖已保存登录态、`HBI_TOKEN` / `--token`，也不依赖实例选择；如果命令提示当前安装还不是 updater-managed，请先重跑一次官方 installer 完成接管。

如果你当前就是通过安装脚本部署 CLI，或者需要在没有本地 updater state 的环境里修复安装，仍然可以直接重跑与安装时相同的命令：

```bash
curl -fsSL https://download.hengshi.com/cli/install.sh | sh
```

Windows PowerShell：

```powershell
irm https://download.hengshi.com/cli/install.ps1 | iex
```

如果你需要手动获取某个指定版本，请前往 `https://github.com/hengshi/cli/releases` 选择对应 release，而不要手工拼接 `download.hengshi.com` 的版本目录地址。

如果只是想通过 installer 路径刷新官方 skills，而不改 CLI 主程序版本，也可以直接重跑 installer 并带 `--with-skills`：

```bash
curl -fsSL https://download.hengshi.com/cli/install.sh | sh -s -- --with-skills
```

升级后建议再次执行：

```bash
hbi --version
hbi auth status --output json
```

如果你在升级后遇到命令入口不一致的问题，请优先重新运行官方 installer 完成接管，并统一以 `hbi` 作为命令入口。