安装完成如何验证

第一步:先看版本和基础入口

先执行:

openclaw --version

如果这条命令都不能正常返回,当前就还不能算“安装成功”。

如果你刚跑完引导或安装流程,也顺手确认一下:

  • 过程是否完整结束;
  • 中途有没有因为权限、凭据或路径问题被打断;
  • 你是否知道接下来该去哪里看状态。

第二步:确认状态能读到

再执行:

openclaw status
openclaw gateway status

你现在至少要能区分这几种情况:

  • 命令根本跑不起来;
  • 程序没有启动;
  • 程序启动了,但状态异常;
  • 程序在运行,而且状态可读。

如果你连当前属于哪一种都分不清,就不要继续做下一步配置。

第三步:看日志是不是稳定

继续执行:

openclaw logs --follow

你要看的不是“日志很多不多”,而是有没有持续性的阻塞错误,例如:

  • 一直重复的认证失败;
  • 配置读取失败;
  • 启动后立刻退出;
  • 某个依赖缺失导致主流程无法继续。

如果日志还在持续报阻塞性错误,也不能算验证通过。

第四步:完成一次最小验证动作

你可以把第一次验证压缩成下面这个标准:

  • 版本能看;
  • 状态能看;
  • 日志能看;
  • 你知道下一步准备去配什么。

如果当前已经具备聊天入口或可用测试场景,也可以再补一轮更强的验证:

  • 改一个最小配置;
  • 重启或重读;
  • 看日志是否反映变化;
  • 看目标行为是否真的改变。

一个够用的最小验证流程

如果你只想快速判断“这次安装算不算成立”,按这个顺序执行:

openclaw --version
openclaw status
openclaw gateway status
openclaw logs --follow

然后确认:

  • 命令是否都能正常执行;
  • 状态是否可读;
  • 日志里是否没有持续性的阻塞错误;
  • 你是否知道下一步要进入配置,而不是继续停留在安装阶段。

如果答案基本都是“是”,这次安装就已经具备继续推进的基础。

常见错误或风险

  • 把单次命令成功误当成服务稳定;
  • 没看日志就默认程序可用;
  • 明明验证没过,却直接进入平台接入页;
  • 看到一条警告就误以为必须重装。

结果判断

验证已经稳定,继续看 配置优先级怎么排
如果你还分不清问题属于安装、启动还是配置,先去 安装失败先看什么;如果问题范围已经扩大,再进入 故障排查总页