Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw 可以为错误报告创建本地诊断 zip。它会合并经过清理的 Gateway 网关状态、健康状况、日志、配置形状，以及近期不含载荷的稳定性事件。 在你审查诊断包之前，应将其视为机密。它们设计上会省略或编辑载荷和凭证，但仍会汇总本地 Gateway 网关日志和主机级运行时状态。

​
快速开始

openclaw gateway diagnostics export
该命令会打印已写入的 zip 路径。要选择路径： 
openclaw gateway diagnostics export --output openclaw-diagnostics.zip
用于自动化： 
openclaw gateway diagnostics export --json

​
聊天命令

所有者可以在聊天中使用 /diagnostics [note] 请求本地 Gateway 网关导出。当错误发生在真实对话中，并且你想要一份可复制粘贴的支持报告时使用它：
  1. 在你发现问题的对话中发送 /diagnostics。如果有帮助，可以添加一条简短备注，例如 /diagnostics bad tool choice。
  2. OpenClaw 会发送诊断前言，并请求一次明确的 exec 批准。该批准会运行 openclaw gateway diagnostics export --json。不要通过允许所有的规则批准诊断。
  3. 批准后，OpenClaw 会回复一份可粘贴的报告，其中包含本地包路径、清单摘要、隐私说明和相关会话 ID。
在群聊中，所有者仍然可以运行 /diagnostics，但 OpenClaw 不会把诊断详情发回共享聊天。它会通过私有批准路径向所有者发送前言、批准提示、Gateway 网关导出结果，以及 Codex 会话/线程拆分信息。群里只会收到一条简短通知，说明诊断流程已私下发送。如果 OpenClaw 找不到私有所有者路由，该命令会以关闭失败方式结束，并要求所有者从私信运行它。 当当前 OpenClaw 会话使用原生 OpenAI Codex harness 时，同一次 exec 批准还会覆盖一次 OpenAI 反馈上传，用于 OpenClaw 知道的 Codex 运行时线程。该上传独立于本地 Gateway 网关 zip，并且只会出现在 Codex harness 会话中。批准前，提示会说明批准诊断也会发送 Codex 反馈，但不会列出 Codex 会话或线程 ID。批准后，聊天回复会列出已发送到 OpenAI 服务器的线程对应的渠道、OpenClaw 会话 ID、Codex 线程 ID 和本地恢复命令。如果你拒绝或忽略该批准，OpenClaw 不会运行导出，不会发送 Codex 反馈，也不会打印 Codex ID。 这让常见的 Codex 调试循环很短：在 Telegram、Discord 或其他渠道中注意到异常行为，运行 /diagnostics，批准一次，与支持人员分享报告，然后如果你想自己检查原生 Codex 线程，就在本地运行打印出的 codex resume <thread-id> 命令。有关该检查工作流，请参阅 Codex harness。

​
导出包含什么

该 zip 包含：
  • summary.md：供支持人员阅读的人类可读概览。
  • diagnostics.json：配置、日志、状态、健康状况和稳定性数据的机器可读摘要。
  • manifest.json：导出元数据和文件列表。
  • 经过清理的配置形状和非机密配置详情。
  • 经过清理的日志摘要和近期已编辑日志行。
  • 尽力获取的 Gateway 网关状态和健康状况快照。
  • stability/latest.json：可用时为最新持久化稳定性包。
即使 Gateway 网关不健康，该导出也很有用。如果 Gateway 网关无法响应状态或健康状况请求，本地日志、配置形状和最新稳定性包仍会在可用时被收集。

​
隐私模型

诊断设计为可共享。导出会保留有助于调试的运行数据，例如：
  • 子系统名称、插件 ID、提供商 ID、渠道 ID 和已配置模式
  • 状态码、时长、字节数、队列状态和内存读数
  • 经过清理的日志元数据和已编辑的运行消息
  • 配置形状和非机密功能设置
导出会省略或编辑：
  • 聊天文本、提示、指令、webhook 正文和工具输出
  • 凭证、API key、令牌、cookie 和机密值
  • 原始请求或响应正文
  • 账户 ID、消息 ID、原始会话 ID、主机名和本地用户名
当日志消息看起来像用户、聊天、提示或工具载荷文本时，导出只会保留一条消息已被省略以及字节数。

​
稳定性记录器

当启用诊断时，Gateway 网关默认会记录一条有界且不含载荷的稳定性流。它用于运行事实，而不是内容。 当 Gateway 网关持续运行但 Node.js 事件循环或 CPU 看起来饱和时，同一个诊断 Heartbeat 会记录存活样本。这些 diagnostic.liveness.warning 事件包含事件循环延迟、事件循环利用率、CPU 核心比率、活跃/等待/排队会话计数、已知时的当前启动/运行时阶段、近期阶段跨度，以及有界的活跃/排队工作标签。空闲样本会以 info 级别保留在遥测中。只有当工作正在等待或排队，或者活跃工作与持续的事件循环延迟重叠时，存活样本才会变成 Gateway 网关警告。在其他方面健康的后台工作期间出现的瞬时最大延迟尖峰会保留在调试日志中。它们本身不会重启 Gateway 网关。 启动阶段还会发出带有墙钟时间和 CPU 计时的 diagnostic.phase.completed 事件。当最后一次 bridge 进度看起来已终止，例如原始响应项或响应完成事件，但 Gateway 网关仍认为嵌入式运行处于活跃状态时，停滞的嵌入式运行诊断会标记 terminalProgressStale=true。 检查实时记录器： 
openclaw gateway stability
openclaw gateway stability --type payload.large
openclaw gateway stability --json
在致命退出、关闭超时或重启启动失败后，检查最新持久化稳定性包： 
openclaw gateway stability --bundle latest
从最新持久化包创建诊断 zip： 
openclaw gateway stability --bundle latest --export
当存在事件时，持久化包位于 ~/.openclaw/logs/stability/ 下。

​
有用选项

openclaw gateway diagnostics export \
  --output openclaw-diagnostics.zip \
  --log-lines 5000 \
  --log-bytes 1000000
  • --output <path>：写入指定的 zip 路径。
  • --log-lines <count>：要包含的经过清理的最大日志行数。
  • --log-bytes <bytes>：要检查的最大日志字节数。
  • --url <url>：用于状态和健康状况快照的 Gateway 网关 WebSocket URL。
  • --token <token>：用于状态和健康状况快照的 Gateway 网关令牌。
  • --password <password>：用于状态和健康状况快照的 Gateway 网关密码。
  • --timeout <ms>：状态和健康状况快照超时。
  • --no-stability-bundle：跳过持久化稳定性包查找。
  • --json：打印机器可读的导出元数据。

​
禁用诊断

诊断默认启用。要禁用稳定性记录器和诊断事件收集： 
{
  diagnostics: {
    enabled: false,
  },
}
禁用诊断会减少错误报告详情。它不会影响正常的 Gateway 网关日志记录。

​
相关