Gateway 诊断包：把问题打包给自己或维护者看
OpenClaw 出问题时，最怕只说一句“它坏了”。诊断包就是把现场材料打包好：版本、配置摘要、插件状态、最近日志、健康检查结果。
你可以把它想成去医院前先做体检。医生不只听你说“我不舒服”，还会看报告。
什么时候需要它？
遇到下面这些情况，可以导出诊断包：
- Gateway 起不来。
- 控制 UI 打不开。
- 通道在线但不回复。
- 节点一直连不上。
- 插件安装后行为不对。
- 你要给维护者提交 issue。
导出诊断包
在运行 OpenClaw 的机器上执行：
bash
openclaw gateway diagnostics export命令会生成一个压缩包，里面是排查问题要看的材料。
如果你是在聊天通道里操作，也可以使用诊断命令：
text
/diagnostics具体能不能用，取决于当前通道、你的权限，以及 Gateway 的配置。
诊断包里通常有什么？
| 内容 | 作用 |
|---|---|
| 版本信息 | 判断你是不是在用旧版本 |
| 环境摘要 | 看 Node、系统、路径是否正常 |
| Gateway 配置摘要 | 看端口、认证、通道、插件等设置 |
| 插件状态 | 判断插件是否加载成功 |
| 健康检查 | 快速看核心服务是否可用 |
| 最近日志 | 找报错、超时、认证失败 |
OpenClaw 会尽量隐藏敏感值，但诊断包仍然可能包含环境路径、通道名称、账号标识或部分运行线索。
发给别人前先检查
请把诊断包当成“半敏感文件”处理。
发给别人前，建议先做三件事：
- 解压看一眼。
- 搜索
token、secret、password、key。 - 确认没有你不想公开的房间名、用户 ID 或服务器地址。
如果你只是自己排查，诊断包可以保留在本机。问题解决后，建议删除旧包，避免以后忘记。
排查顺序建议
新手可以按这个顺序来：
bash
openclaw gateway status
openclaw doctor
openclaw channels status --probe
openclaw logs --follow
openclaw gateway diagnostics export前四个命令像“现场看一眼”，最后一个命令像“把现场封箱带走”。
常见问题
诊断包能自动修复问题吗？
不能。它只是把材料收集起来。真正修复还要根据日志和配置判断。
可以直接把诊断包上传到公开 issue 吗？
不建议直接上传。先检查敏感信息，必要时删掉或打码。
诊断包太大怎么办？
通常是日志太多。你可以先用 openclaw logs --follow 看最近错误，或者只把相关片段发给维护者。