OpenClaw安装避坑指南：常见问题及解决方案汇总

OpenClaw作为一款热门的AI Agent工具，凭借其强大的自动化能力受到了广泛关注。然而，许多用户在安装配置过程中遇到了各种技术障碍，导致无法正常使用。本文基于社区反馈，整理了最常见的安装问题及对应的解决方案，帮助大家绕过这些坑。

Mac用户的专属问题

最普遍的问题是：明明已经安装了Node.js和Git，但OpenClaw仍然提示"未安装"。这通常是因为程序未能正确识别环境变量。解决方法很简单——首先完全退出Cherry Studio（而非仅关闭窗口），然后重新启动。如果问题依旧，重启电脑让PATH环境变量完全生效。Windows用户还需注意，在安装Git时务必选择"Add Git to PATH"选项。

网络连接问题

Mac系统用户常遇到"env: node: No such file or directory"或权限被拒绝的错误。这是因为通过官网下载的安装包路径可能不被Cherry Studio正确识别。建议使用Homebrew安装Node.js：执行brew install node即可。对于权限问题，可以使用nvm进行Node版本管理，安装命令为：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash。

npm错误代码128与GitHub连接超时

由于OpenClaw需要从GitHub下载依赖包，国内网络直连常出现不稳定情况。解决方案包括：开启网络加速工具后重试；多次尝试安装（网络波动可能是偶发性的）；或者强制Git使用HTTPS协议替代SSH。在终端执行以下两条命令即可全局生效：git config --global url."https://github.com/".insteadOf "git@github.com:" 和 git config --global url."https://".insteadOf "git://"。

其他常见问题

启动时报"Process exited with code 1"时，Windows用户应尝试以管理员身份运行Cherry Studio，同时确保Node.js版本为LTS长期支持版。如果在Cherry Studio中找不到OpenClaw图标，需要先在顶部导航栏找到龙虾标签页完成安装，而非在应用列表中寻找。Windows系统下载安装包时可能被拦截，解除方法是在文件属性中勾选"解除锁定"。

如有侵权，请联系删除。