在 Kali 中安装 OpenClaw 时，直接使用 sudo 或默认权限可能会遇到报错。按照以下三个步骤操作，可以确保安装过程顺畅。

第一步：解决权限问题（配置 npm 全局目录）

为了避免因 root 权限导致的安装错误，建议将 npm 的全局包安装在当前用户的家目录下，而不是系统目录。

1. 创建全局包存放目录：

   mkdir -p ~/.npm-global
   

2. 修改 npm 配置指向新目录：

   npm config set prefix '~/.npm-global'
   

3. 将路径添加到环境变量（Kali 默认使用 zsh）：

   echo 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.zshrc
   

4. 使配置立即生效：

   source ~/.zshrc
   

第二步：解决 GitHub 连接问题（绕过 SSH）

OpenClaw 的依赖项（如 libsignal-node）可能会尝试通过 SSH 协议从 GitHub 拉取代码。如果你的机器没有配置 SSH 公钥，或者网络环境拦截了 SSH 端口，会导致安装失败。

解决方法： 强制 git 使用 HTTPS 协议代替 SSH。执行以下命令：

git config --global url."https://github.com/".insteadOf ssh://git@github.com/

第三步：正式安装 OpenClaw

由于官方源在国内或其他特定网络环境下速度较慢，建议使用淘宝镜像源（npmmirror）进行全局安装。

执行安装命令：

npm i -g openclaw --registry=https://registry.npmmirror.com

总结与验证

完成上述步骤后，你可以尝试在终端输入 openclaw 来检查是否安装成功。

💡 小提示： > * 如果你之后更换了 Shell（比如换回了 bash），记得将第一步中的环境变量也添加到 ~/.bashrc 中。

• 如果安装过程中依然提示找不到 npm 命令，请确认你已经预先安装了 Node.js 环境（Kali 可以通过 sudo apt install nodejs npm 安装基础环境）。