用途:对 OpenClaw 运行数据进行系统诊断和性能分析,汇总推理耗时、Token 用量、工具调用统计、Run 时间线和 Gateway 重启历史,帮助排查性能问题和了解各 Agent 活动情况。
主要能力:摘要统计(模型调用次数、平均推理延迟、Token 吞吐量、工具调用次数与成功率、Thinking 统计、Per-Agent 活动分布);完整报告含每个 Run 的时间线、推理耗时、输出 Token、吞吐速率、工具调用参数摘要及最近 20 条错误列表。
使用方式:脚本为 bash scripts/byted-openclaw-diag.sh。常用命令包括 bash scripts/byted-openclaw-diag.sh(今天数据)、bash scripts/byted-openclaw-diag.sh 2026-03-19(指定日期)、bash scripts/byted-openclaw-diag.sh -s(摘要)、bash scripts/byted-openclaw-diag.sh -a waicode(指定 agent)、bash scripts/byted-openclaw-diag.sh -l 5(最近 5 个 Run)。参数可组合,如 -s -a main、-l 3 -a wairesearch。实时跟踪 -f 与高级模式 --advanced 需在 SSH 终端运行,见 references/advanced-mode.md。
数据源:优先读取 debug 日志 /tmp/openclaw/openclaw-YYYY-MM-DD.log(需 diagnostics.enabled: true,精确 Run 边界);无日志时降级为 session 文件 ~/.openclaw/agents//sessions/.jsonl(无需配置,虚拟 Run,核心指标仍准确)。
限制:依赖 python3(3.7+)和 bash;高级模式会临时修改 openclaw.json 并重启 Gateway,退出时自动恢复;时间戳按 UTC 处理;无 Swap 机器上并发多 Agent 需注意内存。输出超 4000 字符时分段发送。其余细节资料未提供。