OpenClaw 踩坑实录：从安装到用上 AI 助手，我踩了这几个坑
折腾了一下午，终于跑起来了。记录一下，帮大家避雷。
先说结论
OpenClaw 是个好东西——本地运行的 AI 助手，数据不上云，还能操作你电脑上的文件。但安装过程真心不顺滑，特别是 macOS 用户。
如果你急着用，直接跳到最后的「一键安装」部分。
我为啥要折腾这个？
之前用 Claude、ChatGPT，总有种"把数据交给别人"的不安全感。而且它们不能访问我的本地文件，每次要复制粘贴，很麻烦。
看到有人说 OpenClaw 可以：
- 本地运行，数据留在自己电脑
- 直接读我的项目文件
- 用我自己的 API key
心想这不就是我想要的吗？开搞。
坑一：官网文档和实际安装对不上
官网说「一键安装」，但点进去发现：
- macOS 要先装 Homebrew
- 还要装 Node.js（我电脑上有，但版本不对）
- 然后才是「一键」
报错信息（大概长这样）：
Error: Node.js version 18.x required, found 16.x
解决：
brew install node@22
装完发现 path 没生效，重启终端才搞定。
坑二：Gateway 启动失败
装完 OpenClaw，按文档运行：
openclaw status
结果：
Gateway service not loaded.
查了半天，发现要先装服务：
openclaw gateway install
openclaw gateway start
文档里没写清楚，是在 GitHub issue 里翻到的。
坑三：API Key 配置容易配错
OpenClaw 支持多个模型（OpenAI、Claude、Moonshot…），但配置格式很迷。
我一开始把 key 写在 config.yaml 里，结果报错说格式不对。后来才发现要放 ~/.openclaw/agents/main/models.json 里。
正确的配置长这样：
{
"moonshot": {
"apiKey": "sk-你的key",
"baseUrl": "https://api.moonshot.cn/v1"
}
}
注意是 baseUrl 不是 baseURL，大小写敏感，坑了我 10 分钟。
坑四：浏览器操作需要 Chrome
我想让 AI 帮我发个 CSDN 文章，结果 OpenClaw 说需要 Chrome/Edge/Brave 浏览器。
我电脑上没有 Chrome（一直用 Safari），现装又慢。
临时解决：先手动操作，后面再考虑装浏览器。
真正跑起来之后
折腾了大概 2 小时，终于看到：
🦞 OpenClaw 2026.2.17
🧠 Model: moonshot/kimi-k2.5
🧮 Tokens: 13k in / 1.5k out
能做什么？
- 直接问我项目里的代码：“这个函数是干嘛的？”——AI 能读到文件内容回答
- 批量改文件名、整理文件夹
- 写脚本、跑命令，不用我复制粘贴
爽点：问"统计一下我今天的 token 用量"，AI 直接调用工具给我算出来，不用我自己查。
一键安装（如果你不想踩坑）
总结的正确姿势：
# 1. 确保 Node.js 22+
node -v # 不是 22+ 就 brew install node@22
# 2. 安装 OpenClaw
brew tap openclaw/tap
brew install openclaw
# 3. 初始化并启动服务
openclaw init
openclaw gateway install
openclaw gateway start
# 4. 配置模型（编辑这个文件）
open ~/.openclaw/agents/main/models.json
# 5. 验证
openclaw status
值不值得折腾？
适合谁：
- 对数据隐私有要求（本地运行）
- 想让 AI 操作本地文件/项目
- 愿意折腾的技术爱好者
不适合谁：
- 想开箱即用（建议直接用 Claude/ChatGPT 网页版）
- 不想折腾命令行
- 电脑配置低（AI 模型虽然远程，但本地也要跑一些服务）
我的环境
- macOS 14.5 (Apple Silicon)
- Node.js 22
- OpenClaw 2026.2.17
- 模型：Moonshot Kimi K2.5
