OpenClaw 支持创建本地诊断 zip 包,用于 bug 报告和支持请求。诊断包设计为可分享,但仍需在分享前审查。
快速导出
openclaw gateway diagnostics export
openclaw gateway diagnostics export --output openclaw-diagnostics.zip
openclaw gateway diagnostics export --json # 自动化模式聊天命令触发
在对话中发送 /diagnostics [备注] 可触发本地 Gateway 导出:
- 发送
/diagnostics后 OpenClaw 请求一次 exec 审批 - 审批后运行
openclaw gateway diagnostics export --json - 回复包含 bundle 路径、manifest 摘要和隐私说明
群聊中:诊断详情通过私有审批路由发给 owner,群组只收到简短通知。
导出内容
zip 包含:
summary.md:人类可读的支持摘要diagnostics.json:配置、日志、状态、健康和稳定性数据的机器可读摘要manifest.json:导出元数据和文件列表- 脱敏的配置结构和非敏感配置详情
- 脱敏的日志摘要和最近的已编辑日志行
stability/latest.json:最新持久化稳定性 bundle
隐私模型
保留(用于调试):
- 子系统名称、插件 ID、提供商 ID、通道 ID、配置模式
- 状态码、持续时间、字节数、队列状态、内存读数
省略或编辑:
- 聊天文本、提示词、指令、webhook 正文、工具输出
- 凭证、API 密钥、令牌、Cookie
- 账户 ID、消息 ID、原始会话 ID、主机名、本地用户名
稳定性记录器
Gateway 默认记录有界的无负载稳定性流。可通过以下命令查看:
openclaw gateway stability
openclaw gateway stability --type payload.large
openclaw gateway stability --bundle latest # 查看最新持久化 bundle
openclaw gateway stability --bundle latest --export # 从 bundle 创建 zip持久化 bundle 存储在 ~/.openclaw/logs/stability/。
常用选项
openclaw gateway diagnostics export \
--output openclaw-diagnostics.zip \
--log-lines 5000 \
--log-bytes 1000000禁用诊断
{
diagnostics: {
enabled: false,
},
}相关链接
- gateway-health — 健康检查
- gateway-opentelemetry — OpenTelemetry 导出
- gateway-logging — 日志配置