安装与部署
这部分解决“把 OpenClaw 装起来并跑通一次”的问题。你可以走交互式流程，也可以用无人值守方式在服务器/CI 环境部署。
推荐流程（从零开始）
- 安装 CLI（npm 或一键脚本）
- 运行初始化向导（onboard）完成基础配置
- 执行健康检查（health/status）确认环境可用
- 按需安装网关服务（gateway install）并保持常驻
全局安装 CLI
基础
安装命令行工具本体。后续所有操作都通过 `openclaw ...` 进行。
$npm i -g openclaw交互式初始化
推荐
首次使用推荐：按步骤完成模型凭证、默认设置、工作区等基础项。
$openclaw onboard快速初始化
快速
减少交互步骤，优先跑通链路；之后再用 `configure` 做精细调整。
$openclaw onboard --flow quickstart无人值守初始化（CI/服务器）
自动化
适合脚本化部署：通过环境变量提供 Token，不进入交互界面。
$openclaw onboard --non-interactive --auth-choice token --token-provider <provider> --token "$TOKEN"查看主命令帮助
常用
遇到不确定的子命令/参数时，先从总览帮助开始。
$openclaw --help安装指定版本（最新稳定版）
版本
显式安装 latest 标签，确保拿到当前稳定版。
$npm i -g openclaw@latest安装 Beta 通道
版本
提前体验新功能，适合测试环境。
$npm i -g openclaw@beta检查并更新 CLI
维护
从当前通道拉取新版本并执行升级，不影响本地配置与数据。
$openclaw update查看更新状态
维护
查看当前安装版本与可用更新信息。
$openclaw update status重置配置（保留 CLI）
排障
仅清空配置恢复默认，不卸载命令行工具。
$openclaw reset --scope config完全卸载（慎用）
维护
移除 CLI 及本地数据；执行前请确认已备份需要保留的内容。
$openclaw uninstall --all --yesℹ️
通用建议
不确定参数时先用 --help；需要机器可读输出时加 --json；问题排查优先从 doctor / status / logs 开始。
快速入口