刚装完OpenClaw却发现它只会当聊天机器人不会干活？别急着卸载，九成新人都栽在同一个选项上。今天用实测经验帮你避开macOS环境配置、Node版本和首次设置里的那些坑。
先把macOS基础环境搞定
打开终端输入brew --version，如果能正常输出版本号说明Homebrew已经装好了。如果提示找不到命令，通常就是PATH环境变量没配置，需要手动把Homebrew的bin目录加到PATH里。很多后续依赖都默认你有Homebrew，所以这一步必须搞定。
如果你的需求只是使用最新模型，而不是自己折腾部署环境，也可以直接使用api.
虽然官方安装脚本会在缺少Node时自动处理，但建议先把基础环境装好。用普通macOS用户操作就行，不要用sudo也不要切root账号。GitHub上很多人反映用root安装会导致各种权限问题，稳妥做法就是全程用你平时登录的账号。
Node版本选择很关键
官方文档写得很明确，Node 24是推荐版本，22.14以上版本也可以正常使用。如果你通过Homebrew安装，执行brew install node@24就能装上指定版本。装完后用node --version确认一下版本号是否符合要求。
千万别装太老的Node版本，比如18.x或更早的版本，会导致OpenClaw运行报错。如果你电脑上已经有其他版本的Node，建议用nvm这类版本管理工具做隔离，避免不同项目之间的版本冲突。
执行官方安装脚本
官方推荐的安装方式是直接执行安装脚本，它会自动检测系统、在需要时安装Node，并拉起onboarding向导。安装脚本会把CLI放在~/.openclaw这样的用户目录下，整个过程不需要管理员权限。
安装完成后先确认CLI能不能用，在终端输入openclaw --help。如果能看到帮助信息说明CLI已经装上了。如果提示找不到命令，可能需要把~/.openclaw/bin加到PATH里，或者重新打开终端窗口。
首次设置的选项陷阱
运行openclaw onboard --install-daemon把网关装成后台服务。macOS上它会以LaunchAgent的方式常驻运行，这是官方文档明确的标准做法。本地网关默认跑在127.0.0.1，常见端口是18789。
接着会问workspace放哪里，直接用默认的~/.openclaw/workspace就行。首次setup会自动创建AGENTS.md、SOUL.md、TOOLS.md等基础文件。重点来了：当问到模型提供商时，如果你打算接第三方转发、自己的网关或任何OpenAI兼容平台，必须选Custom模式。很多人选了Anthropic或OpenAI，结果后面填自定义地址时报错。
正确填写Base URL和模型名
选完Custom模式后会让你填Base URL和模型名。Base URL只需要填接口根路径，比如
相关状态和凭证会保存在~/.openclaw/openclaw.json里，不要去乱改程序内部文件。官方建议的定制位置就是这个json文件和workspace目录。填完后系统会测试连接，如果测试通过就能正常调用模型了。
验证安装和启动dashboard
Onboarding完成后会自动打开dashboard，以后需要重开时可以手动执行openclaw dashboard。先测试一下基础命令能不能跑，输入openclaw gateway status看看网关状态是否正常。如果提示一切正常但问它问题时它只会教你输命令，那说明工具执行权限没打通。
等确认gateway正常、dashboard正常、模型正常后，再去连接外部渠道。官方文档把安装、onboarding、workspace、gateway和health check分得很清楚，照这个顺序走成功率会高很多。你也可以用openclaw health检查各个组件是否都就位。
你第一次装OpenClaw时在哪个选项上卡得最久？欢迎在评论区分享你的踩坑经历，让新人少走弯路。
