前四步参考

OpenClaw的安装部署调试（Ubuntu2204版本）_ubuntu openclaw 版本-CSDN博客

但是第四步 全局安装 OpenClaw 会遇到报错：

:~$ npm install -g openclaw@latest
npm error code EACCES
npm error syscall mkdir
npm error path /usr/lib/node_modules/openclaw
npm error errno -13
npm error Error: EACCES: permission denied, mkdir '/usr/lib/node_modules/openclaw'
……
npm notice
npm error A complete log of this run can be found in: /home/ubuntu/.npm/_logs/2026-03-04T06_56_33_404Z-debug-0.log

原因：npm 默认将全局包安装到系统目录 /usr/lib/node_modules，而普通用户没有写入该目录的权限。

解决：

# 1、在用户主目录下创建一个用于存放全局包的文件夹
mkdir ~/.npm-global

# 2、配置 npm 使用这个新目录
npm config set prefix '~/.npm-global'

# 3、打开或创建 ~/.bashrc 文件，并将新目录的 bin 子目录添加到 PATH 环境变量中
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

# 4、重新加载配置文件
source ~/.bashrc

# 5、验证配置是否生效（应该显示 /home/你的用户名/.npm-global）
npm config get prefix

# 6、现在再次尝试安装 openclaw
npm install -g openclaw@latest

# 7、验证安装
openclaw --version

五、初始化配置（需要重新配置也运行此命令）

openclaw onboard

配置细节可以参考下面这篇中的“完整安装日志”

在 Ubuntu 上快速部署 OpenClaw 完整教程_ubuntu部署openclaw-CSDN博客

其中免费智谱API可以在这里获取：智谱AI开放平台

后面再重启系统就可以使用以下命令启动openclaw

openclaw gateway start

openclaw dashboard