Kali Linux 安装 OpenClaw 详细教程

扑火的小飞蛾2026-04-06 19:40

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

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

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

创建全局包存放目录：
bash 复制代码
```
mkdir -p ~/.npm-global
```
修改 npm 配置指向新目录：
bash 复制代码
```
npm config set prefix '~/.npm-global'
```
将路径添加到环境变量（Kali 默认使用 zsh）：
bash 复制代码
```
echo 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.zshrc
```
使配置立即生效：
bash 复制代码
```
source ~/.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 安装基础环境）。