第一步:先看版本和基础入口
先执行:
openclaw --version如果这条命令都不能正常返回,当前就还不能算“安装成功”。
如果你刚跑完引导或安装流程,也顺手确认一下:
- 过程是否完整结束;
- 中途有没有因为权限、凭据或路径问题被打断;
- 你是否知道接下来该去哪里看状态。
第二步:确认状态能读到
再执行:
openclaw status
openclaw gateway status你现在至少要能区分这几种情况:
- 命令根本跑不起来;
- 程序没有启动;
- 程序启动了,但状态异常;
- 程序在运行,而且状态可读。
如果你连当前属于哪一种都分不清,就不要继续做下一步配置。
第三步:看日志是不是稳定
继续执行:
openclaw logs --follow你要看的不是“日志很多不多”,而是有没有持续性的阻塞错误,例如:
- 一直重复的认证失败;
- 配置读取失败;
- 启动后立刻退出;
- 某个依赖缺失导致主流程无法继续。
如果日志还在持续报阻塞性错误,也不能算验证通过。
第四步:完成一次最小验证动作
你可以把第一次验证压缩成下面这个标准:
- 版本能看;
- 状态能看;
- 日志能看;
- 你知道下一步准备去配什么。
如果当前已经具备聊天入口或可用测试场景,也可以再补一轮更强的验证:
- 改一个最小配置;
- 重启或重读;
- 看日志是否反映变化;
- 看目标行为是否真的改变。
一个够用的最小验证流程
如果你只想快速判断“这次安装算不算成立”,按这个顺序执行:
openclaw --version
openclaw status
openclaw gateway status
openclaw logs --follow然后确认:
- 命令是否都能正常执行;
- 状态是否可读;
- 日志里是否没有持续性的阻塞错误;
- 你是否知道下一步要进入配置,而不是继续停留在安装阶段。
如果答案基本都是“是”,这次安装就已经具备继续推进的基础。
常见错误或风险
- 把单次命令成功误当成服务稳定;
- 没看日志就默认程序可用;
- 明明验证没过,却直接进入平台接入页;
- 看到一条警告就误以为必须重装。
结果判断
验证已经稳定,继续看 配置优先级怎么排。
如果你还分不清问题属于安装、启动还是配置,先去 安装失败先看什么;如果问题范围已经扩大,再进入 故障排查总页。