这份龙虾安装避坑指南，终于整理好了🦞！

📌 一句话摘要

本文是针对 AI Agent 工具 OpenClaw（龙虾）在 Cherry Studio 环境下安装与配置的高频问题答疑指南，涵盖了环境配置、网络连接及安全提示。

📝 详细摘要

文章基于 Datawhale 社区用户在安装 OpenClaw 过程中的 588 条真实反馈，系统性地整理了十大核心避坑指南。内容详细解答了 Node.js 与 Git 环境变量失效、macOS 权限与路径错误、国内 GitHub 网络连接超时、API 密钥配置失效以及模型切换等技术细节问题。作者不仅提供了针对 Windows 和 Mac 系统的具体命令行解决方案，还特别强调了 AI Agent 在获取本地系统权限时的安全风险，是一份极具实践指导意义的工具配置手册。

💡 主要观点

- 环境变量 PATH 的生效问题是导致工具无法识别 Node.js 和 Git 的主因。 即便安装了必要组件，若未重启编辑器或电脑，或安装时未勾选‘添加到 PATH’，系统仍无法调用相关指令，需通过彻底重启或手动配置解决。

macOS 用户常遇权限与路径冲突，推荐使用 Homebrew 或 nvm 进行标准化管理。 Mac 系统对全局 npm 安装有严格权限限制，通过 Homebrew 安装 Node.js 可提供更标准的路径识别，而 nvm 则能有效规避 EACCES 权限错误。

针对国内网络环境，需通过 Git 配置强制使用 HTTPS 代替 SSH 以解决连接超时。 由于 GitHub 访问不稳定，安装依赖时常出现 128 错误码，通过全局命令修改 Git 协议或使用网络加速工具是确保安装成功的关键。

AI Agent 的本地操控权限具有双刃剑属性，用户需具备基本的安全防范意识。 OpenClaw 拥有操控电脑的权限，文章提醒用户仅在信任环境使用，避免让 Agent 处理敏感账号密码或执行不理解的高风险指令。

💬 文章金句

- 安装了 Node.js 和 Git，但 OpenClaw 还是显示'未安装'。这是反映最多的问题，PATH 环境变量需要重启后才能完全生效。

用 Homebrew 安装的 Node.js 路径更标准，Cherry Studio 能正确识别。
OpenClaw 是一个 Agent，它拥有操控你电脑的权限，请只在你信任的环境中使用，不要让它执行你不理解的指令。
正确的流程是：Cherry Studio 顶部导航 → 找到 OpenClaw 的龙虾图标标签页 → 在里面完成安装。装好后，它才会出现在应用列表里。

📊 文章信息

AI 评分：76

来源：Datawhale

作者：Datawhale

分类：人工智能

语言：中文

阅读时间：10 分钟

字数：2255

标签： OpenClaw, Cherry Studio, AI Agent, 环境配置, 故障排查

阅读完整文章

这份龙虾安装避坑指南，终于整理好了🦞！

🤖 問 AI