OpenClaw 支持创建本地诊断 zip 包,用于 bug 报告和支持请求。诊断包设计为可分享,但仍需在分享前审查。

快速导出

openclaw gateway diagnostics export
openclaw gateway diagnostics export --output openclaw-diagnostics.zip
openclaw gateway diagnostics export --json  # 自动化模式

聊天命令触发

在对话中发送 /diagnostics [备注] 可触发本地 Gateway 导出:

  1. 发送 /diagnostics 后 OpenClaw 请求一次 exec 审批
  2. 审批后运行 openclaw gateway diagnostics export --json
  3. 回复包含 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,
  },
}

相关链接