1. OpenClaw 安装前的准备工作
OpenClaw 是一个功能强大的开源自动化工具平台,能够帮助开发者快速构建和部署各类自动化工作流。在开始安装之前,我们需要先了解一些基本概念和准备工作。
1.1 系统环境要求
OpenClaw 支持跨平台运行,但不同操作系统有细微差异:
-
操作系统支持:
- macOS 10.15 (Catalina) 及以上版本
- Linux (Ubuntu 18.04+/CentOS 7+等主流发行版)
- Windows 10/11 (建议使用 WSL2 或原生 PowerShell)
-
Node.js 版本要求:
- 推荐 Node.js 24.x LTS 版本
- 最低要求 Node.js 22.19+
-
其他依赖:
- Git (用于源码安装)
- pnpm (仅源码构建时需要)
- Python 3.8+ (部分插件可能需要)
提示:Windows 用户如果遇到兼容性问题,建议优先考虑 WSL2 环境。原生 Windows 支持虽然存在,但某些高级功能可能受限。
1.2 环境检查与准备
在安装前,建议先检查当前系统环境:
bash复制# 检查 Node.js 版本
node -v
# 检查 npm 版本
npm -v
# 检查 Python 版本
python --version
# 检查 Git 版本
git --version
如果系统中缺少这些基础工具,建议先进行安装。对于 Linux/macOS 用户,可以使用系统包管理器(如 apt/yum/brew)安装;Windows 用户可以从官网下载安装包。
2. OpenClaw 主要安装方式详解
OpenClaw 提供了多种安装方式以适应不同使用场景,下面将详细介绍每种方法的适用场景和具体步骤。
2.1 官方推荐安装脚本(最简单)
这是官方推荐的最简单安装方式,脚本会自动检测系统环境并完成所有必要组件的安装。
macOS/Linux/WSL2 安装命令:
bash复制curl -fsSL https://openclaw.ai/install.sh | bash
Windows PowerShell 安装命令:
powershell复制iwr -useb https://openclaw.ai/install.ps1 | iex
安装脚本会自动:
- 检查并安装合适版本的 Node.js(如果未安装)
- 下载最新版 OpenClaw
- 启动新手引导配置流程
如果想跳过新手引导(例如用于自动化部署):
bash复制curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
2.2 本地前缀安装(隔离环境)
对于希望将 OpenClaw 安装在独立环境而不影响系统全局配置的用户,可以使用本地前缀安装方式:
bash复制curl -fsSL https://openclaw.ai/install-cli.sh | bash
这种方式会将所有依赖安装在 ~/.openclaw 目录下,包括 Node.js 运行时。适合:
- 没有系统管理员权限的用户
- 需要多版本隔离的环境
- 希望保持系统干净的用户
2.3 通过包管理器安装
如果已经自行管理 Node.js 环境,可以通过 npm/pnpm/bun 直接安装:
npm 安装方式:
bash复制npm install -g openclaw@latest
openclaw onboard --install-daemon
pnpm 安装方式:
bash复制pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon
bun 安装方式:
bash复制bun add -g openclaw@latest
openclaw onboard --install-daemon
注意:使用 pnpm 时需要额外运行
pnpm approve-builds -g来批准构建脚本的执行权限。
2.4 从源码构建安装
适合开发者或需要自定义修改的场景:
bash复制git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
或者直接从 GitHub main 分支安装:
bash复制curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main
源码安装需要更多依赖和构建时间,但可以获得最新功能和开发中的特性。
3. 容器化与高级部署方式
对于生产环境或需要隔离的场景,OpenClaw 提供了多种容器化部署方案。
3.1 Docker 部署
使用官方 Docker 镜像是最简单的容器化方式:
bash复制docker pull openclaw/openclaw:latest
docker run -it --rm openclaw/openclaw:latest
对于持久化部署,需要挂载配置和数据卷:
bash复制docker run -d \
--name openclaw \
-v ~/.openclaw:/root/.openclaw \
-v /var/run/docker.sock:/var/run/docker.sock \
-p 3000:3000 \
openclaw/openclaw:latest
3.2 Kubernetes 部署
生产级部署可以使用 Kubernetes:
yaml复制apiVersion: apps/v1
kind: Deployment
metadata:
name: openclaw
spec:
replicas: 1
selector:
matchLabels:
app: openclaw
template:
metadata:
labels:
app: openclaw
spec:
containers:
- name: openclaw
image: openclaw/openclaw:latest
ports:
- containerPort: 3000
volumeMounts:
- mountPath: /root/.openclaw
name: config
volumes:
- name: config
persistentVolumeClaim:
claimName: openclaw-config
3.3 云平台部署
OpenClaw 支持多种云平台一键部署:
Fly.io 部署:
bash复制flyctl launch --image openclaw/openclaw:latest
Railway 部署:
- 创建新项目
- 选择 "Deploy from GitHub"
- 选择 OpenClaw 官方仓库
- 配置环境变量
4. 安装后配置与验证
完成安装后,需要进行基本配置和验证以确保一切正常工作。
4.1 基本验证命令
bash复制# 检查 CLI 是否可用
openclaw --version
# 检查系统配置
openclaw doctor
# 检查网关状态
openclaw gateway status
4.2 后台服务配置
根据操作系统不同,OpenClaw 的后台服务管理方式也不同:
macOS (LaunchAgent):
bash复制openclaw onboard --install-daemon
# 或
openclaw gateway install
Linux/WSL2 (systemd):
bash复制systemctl --user enable openclaw
systemctl --user start openclaw
Windows (计划任务):
powershell复制Register-ScheduledTask -TaskName "OpenClaw" -Trigger (New-ScheduledTaskTrigger -AtLogOn) -Action (New-ScheduledTaskAction -Execute "openclaw" -Argument "gateway start")
4.3 常见问题排查
问题:命令找不到
如果安装后无法识别 openclaw 命令:
bash复制# 检查 Node 是否安装
node -v
# 检查全局包安装位置
npm prefix -g
# 检查 PATH 环境变量
echo $PATH
解决方案:将 npm 全局 bin 目录添加到 PATH:
bash复制export PATH="$(npm prefix -g)/bin:$PATH"
然后将这行添加到 shell 配置文件(~/.bashrc 或 ~/.zshrc)中。
问题:端口冲突
OpenClaw 默认使用 3000 端口,如果冲突可以修改:
bash复制openclaw config set port 4000
5. 进阶配置与使用技巧
5.1 多环境配置管理
OpenClaw 支持通过环境变量管理不同环境的配置:
bash复制# 开发环境
OPENCLAW_ENV=dev openclaw start
# 生产环境
OPENCLAW_ENV=prod openclaw start
配置文件会分别存储在:
- 开发环境:~/.openclaw/dev.config.json
- 生产环境:~/.openclaw/prod.config.json
5.2 插件系统安装
OpenClaw 的强大功能通过插件系统扩展:
bash复制# 列出可用插件
openclaw plugin list
# 安装插件
openclaw plugin install @openclaw/telegram
# 配置插件
openclaw config set plugins.telegram.token YOUR_BOT_TOKEN
5.3 更新与维护
保持 OpenClaw 最新:
bash复制# 稳定版更新
openclaw update --channel stable
# 开发版更新
openclaw update --channel dev
5.4 性能优化建议
对于资源受限的环境:
bash复制# 限制内存使用
openclaw config set gateway.memory_limit 512
# 禁用不需要的插件
openclaw config set plugins.telegram.enabled false
# 调整日志级别
openclaw config set log_level warn
6. 卸载与清理
如果需要完全移除 OpenClaw:
6.1 标准卸载
bash复制openclaw uninstall
6.2 彻底清理
bash复制# 删除配置文件
rm -rf ~/.openclaw
# 删除全局安装
npm uninstall -g openclaw
# 删除 Docker 容器
docker rm -f openclaw
docker rmi openclaw/openclaw
6.3 特定平台清理
macOS:
bash复制launchctl unload ~/Library/LaunchAgents/com.openclaw.plist
rm ~/Library/LaunchAgents/com.openclaw.plist
Linux (systemd):
bash复制systemctl --user disable openclaw
systemctl --user stop openclaw
rm ~/.config/systemd/user/openclaw.service
Windows:
powershell复制Unregister-ScheduledTask -TaskName "OpenClaw" -Confirm:$false
