推荐语

OpenClaw安装避坑指南，帮你轻松解决Node.js和Git安装难题，告别错误提示！

核心内容：
1. 解决OpenClaw显示"未安装"Node.js和Git的高频问题
2. Mac用户专属的权限错误与解决方案
3. Windows系统安装Git时的关键配置要点

杨芳贤

53AI创始人/腾讯云(TVP)最具价值专家

 Datawhale干货 

作者：王熠明、筱可，Datawhale成员

两天内涌来 588 条留言，光错误截图就不下百个。

感谢大家的积极反馈，今天把最高频的问题整理成答疑内容。转发给你的十个龙虾好友，救ta于水火之中🙏

🔴 问题一：安装了 Node.js 和 Git，但 OpenClaw 还是显示"未安装"

这是反映最多的问题，至少有 20+ 位小伙伴中招。

症状是：明明已经按教程把 Node.js 和 Git 都装好了，回到 Cherry Studio 里的 OpenClaw 界面还是提示"需要安装 Node.js"和"需要安装 Git"。

解决方法：

✅ 第一步：完全退出 Cherry Studio，重新打开。很多人只是关掉了窗口，但 Cherry Studio 还在后台运行。需要彻底退出（右键任务栏图标 → 退出），再重新启动。

✅ 第二步：如果还不行，重启电脑。安装 Node.js 和 Git 后，PATH 环境变量需要重启后才能完全生效。

✅ 第三步：Windows 用户安装 Git 时，注意勾选"Add Git to PATH"。安装 Git 时有一步会问是否把 Git 添加到系统路径，一定要选"Git from the command line and also from 3rd-party software"。

🔴 问题二：Mac 用户——"env: node: No such file or directory" / 权限错误

这是 Mac 用户专属的高频错误。

错误信息通常是：

Command failed: "/usr/local/bin/npm" install -g @qingchencloud/openclaw-zh@latestenv: node: No such file or directory

或者：

npm error code EACCESnpm error Error: EACCES: permission denied, mkdir '/usr/local/lib/node_modules'

原因： Cherry Studio 调用 npm 时找不到 Node.js，或者没有足够的系统权限。

解决方法：

✅ 推荐：用 Homebrew 安装 Node.js打开终端，输入：

brew install node

用 Homebrew 安装的 Node.js 路径更标准，Cherry Studio 能正确识别。

✅ 如果遇到权限问题（EACCES）， 可以用 nvm 管理 Node 版本：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

nvm install node

🔴 问题三：npm error code 128 / GitHub 连接超时

错误信息类似：

npm error code 128npm error A git connection error occurredssh: connect to host github.com port 22: Connection timed out

原因： 安装 OpenClaw 时需要从 GitHub 下载依赖包，但国内直连 GitHub 经常不稳定或超时。

解决方法：

✅ 开启网络加速工具后再安装。

✅ 多试几次，有时候是偶发性网络波动，重新点击"安装 OpenClaw"即可。

✅ 错误代码 128 的问题（有同学反映下载龙虾时提示"错误代码128"），同样是 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"

安装路径能看到，但点击"启动"后出现红色提示：

Process exited with code 1

解决方法：

✅ Windows 用户：以管理员身份运行 Cherry Studio右键 Cherry Studio 图标 → 以管理员身份运行，然后重新尝试启动 OpenClaw。

✅ 检查 Node.js 版本，建议安装 LTS 版本（长期支持版），版本过新或过旧都可能导致问题。

✅ 重新安装 OpenClaw：在 OpenClaw 界面点"卸载"，然后重新"安装 OpenClaw"。

🔴 问题五：Cherry Studio 里找不到 OpenClaw 图标（+号里没有）

点击 Cherry Studio 首页的"+"按钮，或者进入"应用"界面，找不到 OpenClaw 的龙虾图标。

原因：OpenClaw 还没有安装完成，或 Cherry Studio 版本较旧。

解决方法：

✅ 先不要找"+"里的 OpenClaw。 正确的流程是：Cherry Studio 顶部导航 → 找到 OpenClaw 的龙虾图标标签页 → 在里面完成安装。装好后，它才会出现在应用列表里。

✅ 如果顶部也没有龙虾标签，说明 Cherry Studio 版本可能太旧，建议更新到最新版本。

🔴 问题六：Cherry Studio 安装包被 Windows 拦截

下载好 Cherry Studio 安装包后，双击提示：

Windows 无法访问指定设备、路径或文件。你可能没有适当的权限访问该项目。

解决方法：

✅ 右键安装包 → 属性 → 勾选底部的"解除锁定" → 确定，再双击安装。

✅ 或者临时关闭 Windows Defender / 杀毒软件，安装完成后再开启。

🟡 问题七：API 密钥相关问题

① 不知道在哪里复制 OpenRouter 密钥

在 OpenRouter 网站创建 API Key 后，密钥只会显示一次，在创建成功的弹窗里。如果没及时复制，需要删掉重新创建一个。

进入 OpenRouter → 左侧菜单 → API 密钥 → 点"创建"→ 立即复制弹出来的 sk-or-... 开头的密钥。

② 令牌无效 / 连接失败

• 检查复制时有没有多复制空格或少复制字符
  

• OpenRouter 的密钥以 sk-or- 开头
  

• 确认 Cherry Studio 里的 API 地址是 https://openrouter.ai/api/v1

③ Create 按钮是灰色，无法创建密钥

OpenRouter 免费账户首次使用可能需要验证或充值少量金额才能激活。部分用户反映账户余额为 0 时无法创建 Key，充值后即可。

④ HTTP 404: No allowed providers are available for the selected model

说明选择的模型暂时不可用。解决方法：换一个其他的免费模型，OpenRouter 上有很多可选的免费模型。

🟡 问题八：一直转圈 / 加载很久进不去

下载 Git 或 Node.js 时一直转圈：这是网络下载速度慢导致的，正常耐心等待即可，不要反复点击。国内下载比较慢，可以考虑手动从官网下载安装包再安装。

OpenClaw 启动时一直转圈：等待 1-2 分钟，首次启动需要初始化。如果超过 5 分钟还没反应，尝试完全退出 Cherry Studio 后重新启动。

OpenClaw 对话一直在跑停不下来：有同学说 OpenClaw 疯狂输出停不下来，可以在 Cherry Studio 界面点击停止按钮，或者重新打开一个对话窗口。这通常是 Agent 模式陷入了循环，换一个问法或换个模型重试。

🟡 问题九：web_search 不可用（缺 Brave API key）

使用 OpenClaw 时提示：

web_search 暂时不可用（缺 Brave API key）

这是因为 OpenClaw 的网络搜索功能需要单独配置 Brave Search 的 API Key。没有这个 Key 的情况下，OpenClaw 的其他功能仍然正常使用，只是不能联网搜索实时信息。

如果你需要网络搜索功能，可以去 Brave Search API 注册获取免费 Key，然后在 OpenClaw 的配置中填入。

🟡 问题十：免费模型不能用了 / 如何换模型

在 Cherry Studio 的对话界面（聊天窗口）顶部或输入框附近，点击当前显示的模型名称（通常是最上面或对话标题处），弹出下拉列表，选择想要切换的模型即可。然后到openclaw应用加载新模型重启即可。你可以换成你购买的coding plan。

⚠️ 顺便说一句：安全性的问题

有不少同学问到 OpenClaw 的安全问题，也有同学提醒大家注意安全风险。

OpenClaw 是一个 Agent，它拥有操控你电脑的权限，请只在你信任的环境中使用，不要让它执行你不理解的指令，也不要把重要账号密码放在它能访问到的地方。

本文根据 588 条用户留言整理，感谢每一位留言的小伙伴！