安装

约 679 字大约 2 分钟

安装方法

OpenClaw 提供一键安装脚本，适用于 macOS 与 Linux。内容基于官方 Installer。

使用方式

curl -fsSL https://openclaw.ai/install.sh | bash

脚本会：

检测并安装 Node.js（若未安装或版本不足）
使用 npm 或 pnpm 全局安装 openclaw@latest
根据需要配置环境

指定安装方式（如 git）

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

从源码安装时，需在克隆的仓库内执行 pnpm install、pnpm build 等，详见快速开始。

Docker安装

使用 Docker 运行 OpenClaw 的方式。内容基于官方 Docker。

使用官方镜像

仓库提供 Dockerfile 与 docker-compose 配置。克隆后：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
## 参考仓库内 docker-compose.yml 与文档

具体步骤、环境变量与卷挂载请以仓库内 docs 或 README 为准。

注意点

网关需持久化配置与状态目录（如 ~/.openclaw）
通道登录产生的凭证需挂载进容器或通过配置注入
若需在宿主机访问控制台，需映射对应端口（如 18789）

更新升级

升级或切换 OpenClaw 版本的方式。内容基于官方 Updating。

更新到最新稳定版

npm install -g openclaw@latest
## 或

若已通过向导安装了系统服务，更新后一般无需重新配置；必要时可运行：

openclaw doctor

以检查并修复网关服务入口等。

切换发布频道

stable：正式发布（latest）
beta：预发布（beta）
dev：开发版（dev，若已发布）

openclaw update --channel stable   # 或 beta / dev

详见开发频道。

回滚

重新安装指定版本即可，例如：

npm install -g openclaw@1.2.3

再运行 openclaw doctor 确保服务指向正确二进制。

卸载

完全卸载 OpenClaw。

CLI 卸载

## 交互式
openclaw uninstall

## 卸载服务
openclaw uninstall --service

## 删除状态
openclaw uninstall --state

## 删除工作区
openclaw uninstall --workspace

## 完全卸载

手动卸载

1. 停止服务

openclaw gateway stop

2. 卸载服务

macOS:

launchctl unload ~/Library/LaunchAgents/com.openclaw.gateway.plist

Linux:

systemctl --user stop openclaw
systemctl --user disable openclaw

3. 删除数据

rm -rf ~/.openclaw

4. 卸载 CLI

npm uninstall -g openclaw

或删除 git 检出：

rm -rf ~/openclaw  # 或你的检出目录

保留数据

如果只想重装但保留数据：

## 仅卸载服务和 CLI
openclaw uninstall --service
npm uninstall -g openclaw

重装后数据会自动使用。

开发通道

OpenClaw 有多个发布通道。

通道

通道	npm 标签	说明
stable	`latest`	稳定版
beta	`beta`	测试版
dev	`dev`	开发版

安装不同通道

Stable（默认）

curl -fsSL https://openclaw.bot/install.sh | bash

Beta

curl -fsSL https://openclaw.bot/install.sh | bash -s -- --beta

Dev（Git）

curl -fsSL https://openclaw.bot/install.sh | bash -s -- --install-method git

切换通道

## 切换到 beta
openclaw update --channel beta

## 切换到 stable
openclaw update --channel stable

## 切换到 dev

查看版本

openclaw --version