环境信息
- 系统: Ubuntu 22.04 LTS
- 配置: 4 核 8GB 内存,100M 带宽
- 类型: CPU
一、安装依赖
1.1 更新系统包索引
sudo apt update
1.2 安装 curl
sudo apt install -y curl
1.3 通过 NodeSource 安装最新稳定 LTS 版本
添加 NodeSource 仓库并安装:
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
安装完成后验证版本:
node -v
npm -v
实际输出示例:
v24.14.0
11.9.0
1.4 设置淘宝镜像(最常用)
npm config set registry https://registry.npmmirror.com
npm config get registry
验证输出:
https://registry.npmmirror.com
二、安装 OpenClaw
执行官方安装脚本。注意:安装过程中若提示确认,请勾选 yes。
curl -fsSL https://openclaw.ai/install.sh | bash
关键日志摘要:
安装过程会自动检测环境、配置 npm 全局路径及 systemd 服务。重点关注以下两点:
- 安装成功提示:
OpenClaw installed successfully (版本号)! - PATH 警告:如果看到
PATH missing npm global bin dir,说明命令无法在终端直接调用,需按后续步骤修复。
安全提示:
OpenClaw 默认是个人助手模式,涉及文件读取和工具执行权限。生产环境部署前请务必阅读安全文档,建议开启 Pairing/Allowlists 并最小化工具权限。
三、解决 PATH 问题
安装完成后,如果执行 which openclaw 找不到命令,需要手动配置环境变量。
# 检查 openclaw 是否在 PATH 中
which openclaw
# 如果找不到,查看 npm 全局安装目录
npm prefix -g
>> ~/.bashrc
~/.bashrc
| grep npm





