在 Kali 中安装 OpenClaw 时,直接使用 sudo 或默认权限可能会遇到报错。按照以下三个步骤操作,可以确保安装过程顺畅。
第一步:解决权限问题(配置 npm 全局目录)
为了避免因 root 权限导致的安装错误,建议将 npm 的全局包安装在当前用户的家目录下,而不是系统目录。
-
创建全局包存放目录:
bashmkdir -p ~/.npm-global -
修改 npm 配置指向新目录:
bashnpm config set prefix '~/.npm-global' -
将路径添加到环境变量(Kali 默认使用 zsh):
bashecho 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.zshrc -
使配置立即生效:
bashsource ~/.zshrc
第二步:解决 GitHub 连接问题(绕过 SSH)
OpenClaw 的依赖项(如 libsignal-node)可能会尝试通过 SSH 协议从 GitHub 拉取代码。如果你的机器没有配置 SSH 公钥,或者网络环境拦截了 SSH 端口,会导致安装失败。
解决方法: 强制 git 使用 HTTPS 协议代替 SSH。执行以下命令:
bash
git config --global url."https://github.com/".insteadOf ssh://git@github.com/
第三步:正式安装 OpenClaw
由于官方源在国内或其他特定网络环境下速度较慢,建议使用淘宝镜像源(npmmirror)进行全局安装。
执行安装命令:
bash
npm i -g openclaw --registry=https://registry.npmmirror.com
总结与验证
完成上述步骤后,你可以尝试在终端输入 openclaw 来检查是否安装成功。
💡 小提示: > * 如果你之后更换了 Shell(比如换回了 bash),记得将第一步中的环境变量也添加到
~/.bashrc中。
- 如果安装过程中依然提示找不到
npm命令,请确认你已经预先安装了 Node.js 环境(Kali 可以通过sudo apt install nodejs npm安装基础环境)。