ubuntu22.04部署openclaw
前四步参考
关于OpenClaw的安装部署调试(Ubuntu 2204版本),可以参考这篇详细的教程: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、将新目录的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