Kali Linux 安装 OpenClaw 完整步骤指南

在 Kali Linux 系统中安装 OpenClaw 时，如果直接使用 sudo 权限或默认安装方式，大概率会遇到因权限和网络环境导致的安装失败问题。本教程将提供一套完整的解决方案，通过三个关键步骤彻底解决这些常见错误，确保你的 OpenClaw 安装过程顺畅无阻。

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

绝大多数安装错误都源于 root 用户权限与 npm 包管理器的冲突。最稳妥的解决方案是将 npm 的全局包安装路径配置到当前用户的家目录下，从而完全规避权限冲突的风险。请按顺序执行以下命令：

1. 创建专用的全局包存放目录：
   mkdir -p ~/.npm-global
2. 修改 npm 配置，指向新的目录：
   npm config set prefix '~/.npm-global'
3. 将新路径添加到系统环境变量中（Kali Linux 默认使用 zsh Shell）：
   echo 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.zshrc
4. 立即刷新 Shell 配置使其生效：
   source ~/.zshrc

第二步：解决 GitHub 连接问题（强制使用 HTTPS 协议）

OpenClaw 的部分核心依赖（例如 libsignal-node）在安装时可能会默认通过 SSH 协议从 GitHub 仓库拉取代码。如果你的 Kali Linux 系统未配置 SSH 密钥，或者所在网络环境限制了 SSH 端口（22端口）的访问，安装进程就会在此处中断并报错。

解决方法非常直接：通过 Git 配置，强制将所有指向 GitHub 的 SSH 协议请求转换为更通用的 HTTPS 协议。只需执行这一条命令：

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

第三步：正式安装 OpenClaw（使用国内镜像加速）

由于官方 npm 仓库的服务器位于海外，在国内网络环境下下载速度可能非常缓慢甚至超时。为了显著提升安装成功率与速度，强烈建议在安装时指定使用国内的淘宝 npm 镜像源（npmmirror）。

执行以下全局安装命令：

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

安装完成与验证

顺利执行完上述所有步骤后，OpenClaw 应该已经成功安装到你的系统中。你可以在终端中输入以下命令来验证安装是否成功：

openclaw