OpenClaw 本地安装踩坑记录：我是怎么一步步装起来的
前两天折腾 OpenClaw，前后重装了几次，最后总算把本地、网页、飞书这条链路跑通了。
网上教程不是没有，但很多地方默认你已经懂了。你真自己上手的时候，最容易卡住的反而不是“大步骤”，而是那些没人提醒的小地方。所以我干脆把自己这次实际怎么装、怎么排坑，按顺序记一遍。后面自己复盘方便，也给第一次装的人做个参考。
一开始别急着跑脚本，先看 Node 对不对
我一开始就是太快了，看到安装命令就直接跑，后面才发现问题根本不在 OpenClaw，而是在 Node 版本。
先看这两个：
node -v
which node
OpenClaw 这套东西，Node 版本太低，后面就算勉强装上了，也很容易出现命令能跑、实际功能不正常的情况。
我的建议很简单：先把 Node 处理到 22+，再继续。不要图省事。
我这里是直接用 nvm 切版本的
如果你本机已经装了 nvm，那这一步其实很省事：
nvm install 25
nvm use 25
nvm alias default 25
node -v
我最后实际用的是：
v25.8.0
不一定非得跟我一样，只要你是 22 以上就行。
我个人还是更建议用 nvm，后面别的项目如果要切低版本，也不会把系统环境弄乱。
环境对了之后，再装 OpenClaw
这一段没什么花活，装上就行。常见做法就两种。
如果你想按官方方式来：
curl -fsSL https://install.openclaw.ai | bash
如果你更习惯用 npm：
npm install -g openclaw@latest
装完我会先确认两件事：
openclaw –version
which openclaw
这一步不要省。因为有时候看起来装完了，实际上命令没进环境变量，或者终端用的根本不是你刚装的那个版本。
装完别一口气全配，先跑最小链路
这个是我后面回头看，觉得最重要的一点。
刚装好的时候，真的不要一上来就把飞书、浏览器控制、自动发内容这些东西全开上去。这样一旦出问题，你根本不知道是哪一层坏了。
我后面比较稳的做法是：先只管最小可用链路。
也就是先确保下面这几件事能通：
- OpenClaw 命令能正常执行
- 本地网关能启动
- Web 界面能打开
- 发一句最简单的话，它能正常回
初始化我用的是这类命令：
openclaw onboard –mode local –flow quickstart
你也可以走 configure 或者别的引导流程，但核心思路别变：先把主链路跑起来，别急着扩。
然后我把网关服务装上
很多人会误以为“我已经能敲 openclaw 了”，那就算装好了。其实不是。
真正能不能用，关键看网关服务有没有起来。
我这边实际会跑这几条：
openclaw gateway install
openclaw gateway start
openclaw gateway status
openclaw health
如果这里状态不正常，后面就先别折腾别的了，先把网关处理好。
因为飞书不回、网页打不开、聊天没反应，很多时候根本不是模型问题，就是服务没起来或者起得不对。
网页先测最简单的一句，不要一上来就发复杂任务
服务起来之后，我先开的不是飞书，而是网页。
我一般就丢一句最简单的话进去：
你是谁？
它能正常回复，我才继续下一步。
如果连这句都回不了，那就说明最基础的聊天链路都没通。这个时候去折腾飞书、浏览器、自动化发帖，其实是在给自己加工作量。
模型我也是后面才接的，而且一次只接一个
我自己的习惯是，不要一开始同时配三四个模型。
先接一个主模型，把回复稳定性跑出来。等这一步没问题了，再考虑图片模型、备用模型这些东西。
我后面把默认模型统一切成了：
openai-codex / gpt-5.3-codex
这一点我特意提一下，是因为很多人改完配置文件就以为结束了。其实还差一步：
openclaw gateway restart
不重启，很多配置就是写在文件里，看着改了，实际上运行中的服务还在用旧的。
飞书我是在主链路跑通之后才接的
我这次最大的教训之一，就是不要本地还没稳，就急着接飞书。
正确顺序我现在会这么走：
飞书这边本身不复杂，核心就是：
- 去飞书开放平台建应用
- 拿 App ID 和 App Secret
- 写进 OpenClaw 配置
- 重启网关
- 再做消息测试和配对
如果飞书发消息没反应，我现在不会第一时间怀疑模型，而是直接查状态和日志：
openclaw channels status
openclaw channels logs –channel feishu –lines 40
openclaw pairing list feishu
这比在那里猜“是不是接口炸了”“是不是机器人傻了”有用得多。
我这次遇到的几个典型坑
1. 命令能跑，不代表真的装好了
这个坑特别常见。
表面上看：
- openclaw –version 有输出
- 命令也能敲
但实际上：
- 网页打不开
- 聊天没反应
- 飞书也不回
这种时候先别乱改配置，先看：
openclaw gateway status
openclaw health
很多问题到这里就能定位了。
2. 飞书发过来的消息，主页面里不一定能直接看到
这个我一开始也踩了。
不是每次都真坏了，有时候是会话隔离的问题。也就是飞书一套 session，网页一套 session，你以为它们应该在一个地方，其实没有。
所以如果你看到“飞书明明发了，网页里怎么没显示”，别先下结论说它不能用，先去看会话和渠道日志。
3. 改了模型，结果实际还在跑旧配置
这个我后面也碰到了。
文件里看着已经改掉了，但实际会话还是旧模型。最后排下来，根源通常就两个：
- 服务没重启
- 你看的不是实际运行中的会话配置
所以现在我的习惯就是三步：
别只相信“我已经改过了”，要看“它现在到底在跑什么”。
如果让我重来一次，我会直接这样装
现在回头看，最省时间的顺序其实就是下面这套。
第一步，先把 Node 搞到 22+
node -v
nvm install 25
nvm use 25
第二步，安装 OpenClaw
npm install -g openclaw@latest
openclaw –version
第三步，做本地初始化
openclaw onboard –mode local –flow quickstart
第四步，把网关跑起来
openclaw gateway install
openclaw gateway start
openclaw health
第五步，先去网页里发一句最简单的话
你是谁？
这句都能稳稳回，再继续。
第六步，模型通了以后再接飞书
顺序别反。你越往后接，排问题越清楚。
最后说句实在话
我这次装下来最大的感受就是：OpenClaw 不是那种“复制一条命令就万事大吉”的东西。
真正省时间的方法，不是找一篇最炫的教程从头抄到尾，而是老老实实按层次来：
先环境，再安装，再网关，再网页，再模型，最后才是飞书和自动化。
这样每一步都能验证，哪一步坏了也很容易看出来。虽然表面上像是慢一点，但实际上会少走很多回头路。
如果后面我还有空，我准备把这几个也顺手整理出来：
- OpenClaw + 飞书 的对接过程
- OpenClaw 切到 gpt-5.3-codex 的过程
- 我自己遇到过的几类常见报错和处理方法
