OpenClaw 诊断命令手册：status、doctor、logs 与求助姿势
OpenClaw 的自诊断工具链相当完整，大部分问题在开 issue 之前就能自己定位。这页按「症状 → 命令」整理官方推荐的诊断路径。
状态三连（先跑这三条）
openclaw status # 网关/智能体健康 + 配置快照
openclaw gateway status --deep # 网关、配置、插件深度体检
openclaw models status # 提供商验证状态与模型可用性- status 快速确认「活着吗、配置对吗」；--all 参数生成可直接粘贴的完整只读诊断。
- models status 专治「它突然不回话」——八成是提供商验证或额度问题。
doctor：自动修配置
openclaw doctor # 检查并报告
openclaw doctor --fix # 检查并修复职责包括：验证配置结构、清理停用键（版本升级后跑一次是惯例）、迁移旧格式（比如旧版心跳文件导入心跳暂存区、@用户名白名单换成数字 ID）、补建缺失的系统任务。它是修复配置与状态问题的官方入口，动手改配置前先让它看一遍。
日志
openclaw logs --follow # 实时跟踪查渠道 ID（Telegram 群 ID、用户 ID）、看消息为什么没触发、看配对请求，都在日志里。官方甚至建议把「向机器人发消息然后看日志」作为查询身份信息的安全方式。
更多专项命令
- openclaw health --verbose ——详细健康报告。
- openclaw sessions ——会话列表与管理。
- openclaw tasks list / audit ——后台任务台账与审计。
- openclaw security audit ——安全体检（见 安全加固）。
求助的正确姿势
官方 FAQ 给的求助清单：先让一个能看你机器的本地编码智能体（Claude Code、Codex 这类）直接读配置和日志——比在社区里猜快得多。仍要发帖时，附上 status --all、doctor、models status 的输出；确认真 bug 就去仓库提 issue。
排查心法
先分清三层：进程层（网关活着吗 → status）、配置层（键写对了吗 → doctor）、模型层（提供商通吗 → models status）。九成问题落在这三层的某一层，逐层排除比乱试快。