OpenCLAW Linux 部署与配置实战指南
环境准备与前置条件
正式动手前,先核对一下环境清单。OpenCLAW 对基础依赖有明确要求,避免后续安装踩坑:
| 环境组件 | 版本要求 | 验证命令 |
|---|---|---|
| Node.js | 22.0.0 或更高版本 | node --version |
| npm | 对应 Node.js 版本 | npm --version |
| Python | 3.8 或更高版本 | python3 --version |
| 系统内存 | ≥ 2GB | free -h |
| 网络连接 | 稳定互联网连接 | ping -c 3 google.com |
Node.js 环境配置
若当前环境缺少对应版本,建议用 NVM 管理,这样切换更灵活:
# 安装 NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 重新加载 shell 配置
source ~/.bashrc
# 安装 Node.js 22
nvm install 22
nvm use 22
nvm alias default 22
# 验证安装
node --version
npm --version
OpenCLAW 核心安装步骤
方法一:npm 全局安装(推荐)
核心安装过程其实很简洁,两条命令就能搞定:
# 1. 全局安装 OpenCLAW(忽略构建脚本以避免潜在兼容性问题)
npm install -g openclaw@latest --ignore-scripts
# 2. 初始化配置并安装守护进程
openclaw onboard --install-daemon
安装完成后,系统会自动启动 OpenCLAW 服务。你可以用下面这些命令验证服务状态:
# 检查服务运行状态
systemctl status openclaw
# 查看 OpenCLAW 版本信息
openclaw --version
方法二:国内镜像加速安装
国内用户常遇下载慢的情况,可用淘宝 npm 镜像源提速:
# 配置 npm 使用国内镜像
npm config set registry https://registry.npmmirror.com/
# 安装 OpenCLAW
npm install -g openclaw@latest --ignore-scripts
# 恢复官方源(可选)
npm config set registry https://registry.npmjs.org/

