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：

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

Windows PowerShell：

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

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

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：

& ([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 下载对应版本的发布包：

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

对应 release 页面中可以下载：

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

安装后验证

至少完成下面三步：

hbi --version
hbi --help
hbi auth status

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

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

如果是自动化环境，或当前运行时不适合弹系统钥匙串，优先使用显式的 HBI_HOST + HBI_CLIENT_ID + HBI_CLIENT_SECRET，并按需设置 HBI_DISABLE_KEYRING=true。完整的 host / auth 决策表见 认证与连接。

升级说明

升级不需要单独的“升级下载地址”。如果当前 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

hbi update --check
hbi update
hbi update --with-skills

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

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

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

Windows 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：

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

升级后建议再次执行：

hbi --version
hbi auth status --output json

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