这页是“命令阶梯”版排障指南。遇到安装、启动、连接问题时，按顺序执行即可快速判断是环境问题、服务问题，还是渠道/模型问题。
本章完成标准
你读完后应该能用一组固定命令，把问题从“现象”定位到“具体层级”。
步骤一：先确认基础运行状态
openclaw status
openclaw gateway status
openclaw doctor这一步先排除“服务没起来”与“环境不满足”。
步骤二：再看实时日志
openclaw logs --follow日志会直接告诉你是端口冲突、认证失败、依赖缺失，还是外部 API 报错。
步骤三：最后验证渠道与路由
openclaw channels status --probe这一步排查“服务正常但消息不通”的问题最有效。
常见现象与优先检查点
- 命令不存在：先检查安装路径和 PATH。
- Dashboard 打不开：先查 gateway 状态与端口。
- 渠道不回复：先查 token、配对、路由策略。
- 模型不工作：先查 provider 配置、网络、代理与额度。
一组可复制的最小排障流程
openclaw status
openclaw gateway status
openclaw doctor
openclaw logs --follow
openclaw channels status --probe