执行步骤
- 第一步看端口：Gateway `18789`、Web UI `3000` 是否被占用。
- 第二步看版本：Node、包管理器、锁文件是否一致。
- 第三步看配置：环境变量是否缺失，配置键名是否拼错。
- 第四步看日志：先看第一条关键错误，再追后续堆栈。
- 每改一项就重试一次，记录结果，避免混改。
- 问题定位后把处理步骤写进团队排障手册。
OpenClaw FAQ：启动失败时先查哪 5 项
高频启动问题的快速定位顺序，减少盲目重装。
适用场景
线上出现故障，需要快速恢复服务
预计阅读
6 分钟
完成结果
你会得到一条可复用的排障路径
关键命令
lsof -i :18789
lsof -i :3000
openclaw logs --tail 200常见风险
- 同一时间只改一类变量，避免问题互相覆盖。
- 所有变更都保留可回滚路径与日志证据。
高频失败案例
- 只看最后一行报错，忽略第一条关键错误。
- 没固定排查顺序，重复尝试导致耗时翻倍。
完成验收
- 可复现
- 可回滚
- 可监控
继续深入
先完成本页验收项，再看同分类文章，把流程串成完整闭环。