OpenClaw 配置最容易卡住的地方,不是写 prompt,而是登录和权限。很多人会遇到 OAuth 登录失败、模型列表为空、Codex 不可用、飞书连接不畅、GPT 模型配置报错等问题。
这篇文章按排查顺序整理,适合遇到问题时一步步检查。
一、先确认账号和订阅
OAuth 登录失败时,第一步不是改配置,而是确认账号:
- 是否登录了正确的 ChatGPT 账号;
- 账号是否有对应订阅权限;
- 浏览器里是否切到了另一个账号;
- 组织或团队权限是否限制模型使用。
很多“模型不可用”其实不是 OpenClaw 坏了,而是账号入口没有权限。
二、检查 OpenClaw 版本
如果你看到教程里有某个模型入口,但自己界面没有,先检查版本。OpenClaw、Codex、GPT 模型适配都可能随版本变化。旧版本不支持新入口,是很常见的问题。
三、检查 OAuth 回调和网络
OAuth 依赖浏览器跳转和本地回调。如果本地端口被占用、代理配置异常、浏览器拦截跳转,都会失败。
可以检查:
- 默认浏览器是否能正常打开授权页;
- 代理或网络是否拦截登录;
- 本地回调端口是否被占用;
- 授权后是否返回 OpenClaw;
- 是否保存了过期 token。
四、飞书连接不畅怎么办?
如果 OpenClaw 通过飞书接收指令,飞书链路也要单独排查。消息发出后没有响应,不一定是模型问题,也可能是机器人、回调、权限或网络的问题。
建议先用一个最小任务测试,比如“回复收到”。确认飞书到 OpenClaw 的链路正常后,再测试模型调用。
五、什么时候该换 Codex 执行?
如果你要做正式发文、改代码、发布 WordPress、配置标签图片,我建议把 OpenClaw 当入口,把 Codex 当执行端。OpenClaw 适合收任务,Codex 更适合稳定落地。
相关对比可以看 我为什么把博客更新从 OpenClaw 转到 Codex。
排查清单
- 确认账号和订阅;
- 升级 OpenClaw;
- 清理旧 token 后重新 OAuth;
- 检查浏览器、代理和回调端口;
- 先测飞书消息链路;
- 再测模型调用;
- 最后再跑长任务。