mcpField
B
byted-openclaw-diag

byted-openclaw-diag

github.com/bytedanceAgent workflows47744 installsUpdated today
Repository

About byted-openclaw-diag

A diagnostic skill for reviewing OpenClaw activity, intended for operators investigating agent runs. It produces summary or full reports and supports filtering by date, agent, and number of recent runs.

Key features

  1. 01Generate a daily activity summary
  2. 02View run details, timelines, and errors
  3. 03Filter diagnostics by date
  4. 04Filter activity by agent
  5. 05Inspect recent runs

Use cases

  1. 01Quickly review the day's activity
  2. 02Investigate run errors and slowdowns
  3. 03Analyze activity for a specific agent
  4. 04Follow activity live in an SSH terminal

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bytedance/agentkit-samples --skill byted-openclaw-diag

After installing, type/byted-openclaw-diagin Claude Code to confirm it loaded.

Bundled filesreferences/advanced-mode.mdscripts/byted-openclaw-diag.sh

Details

From the project README

OpenClaw 诊断工具

指令模式

当用户发送 /diag 指令时，直接执行脚本，不做额外解释：

用户输入执行命令说明
/diag-s今日摘要（默认）
/diag full(无-s)完整报告（含 Run 详情 + 错误列表）
/diag full -l 3-l 3最近 3 个 Run 完整详情
/diag -a waicode-s -a waicode指定 agent 摘要
/diag -a main full-a main指定 agent 完整报告
/diag 2026-03-19-s 2026-03-19指定日期摘要
/diag errors(无-s)执行完整报告，只提取错误部分汇总

规则：

  1. 无参数时默认 -s（摘要模式，最简洁）
  2. full 关键词 → 去掉 -s，输出含 Run 详情
  3. errors 关键词 → 执行完整报告，只摘出错误列表
  4. -a、-l、日期参数直接透传给脚本
  5. 去除 ANSI 颜色码：管道 | sed 's/\x1b\[[0-9;]*m//g'
  6. 不支持 -f（实时跟踪），该模式需在 SSH 终端运行
  7. 直出模式：脚本输出直接用 message 工具原样发送给用户，不经过模型总结。 具体做法：
    • 执行脚本，将 stdout 存入变量
    • 用 message(action="send", message=output) 发送原始输出
    • 然后回复 NO_REPLY（避免重复发送）
    • 如果输出超过 4000 字符，按 4000 字符分段发送（Telegram 消息长度限制）
    • 每段用 ``` 代码块包裹，保持等宽字体排版

自然语言模式

当用户用自然语言询问（如"运行状态怎么样"、"waicode今天干了啥"）时， 自行选择合适参数执行脚本，并用中文汇总关键信息。

快速使用

# 诊断今天的数据
bash scripts/byted-openclaw-diag.sh

# 诊断指定日期
bash scripts/byted-openclaw-diag.sh 2026-03-19

# 只看摘要
bash scripts/byted-openclaw-diag.sh -s

# 实时跟踪（类似 tail -f）
bash scripts/byted-openclaw-diag.sh -f

# 高级实时跟踪（自动开启 debug 日志，退出时恢复）
bash scripts/byted-openclaw-diag.sh -f --advanced

# 只看指定 agent
bash scripts/byted-openclaw-diag.sh -a waicode

# 最近 5 个 Run
bash scripts/byted-openclaw-diag.sh -l 5

模式说明

模式参数说明
摘要统计-s（默认）KPI 概览，最简洁
完整报告无 -s含 Run 详情 + 时间线 + 错误列表
Agent 过滤-a <name>只看指定 agent
限制数量-l N只显示最近 N 个 Run
指定日期YYYY-MM-DD默认今天

参数可组合：-s -a main、-l 3 -a wairesearch。

实时跟踪（-f）和高级模式（--advanced）需在 SSH 终端运行， 详见 references/advanced-mode.md。

数据源

脚本有两种数据源，自动切换：

数据源路径需要配置精度
Debug 日志/tmp/openclaw/openclaw-YYYY-MM-DD.logdiagnostics.enabled: true精确 Run 边界
Session 文件~/.openclaw/agents/*/sessions/*.jsonl无需配置虚拟 Run（消息时间戳推算）

无 debug 日志时自动降级为 session 模式，核心指标（推理耗时、Token、工具统计）仍然准确。

输出内容

摘要统计
  • 模型调用次数、平均推理延迟、Token 吞吐量
  • 工具调用次数、成功率、总耗时
  • Thinking 统计（次数、平均深度）
  • Per-Agent 活动分布
Run 详情（非摘要模式）
  • 每个 Run 的时间线（推理段 + 工具调用段）
  • 推理耗时、输出 Token、吞吐速率
  • 工具调用参数摘要
错误列表
  • 最近 20 条错误，按时间倒序

使用指南

日常检查
# 快速了解今天的运行概况
bash scripts/byted-openclaw-diag.sh -s
性能排查
# 查看某天详细 Run 数据，找到慢查询
bash scripts/byted-openclaw-diag.sh 2026-03-19 -l 10
特定 Agent 分析
# 只看 waicode 的活动
bash scripts/byted-openclaw-diag.sh -a waicode -s
实时监控（SSH 终端）
# 需在 SSH 终端运行，不适合 Telegram/聊天
bash scripts/byted-openclaw-diag.sh -f
bash scripts/byted-openclaw-diag.sh -f --advanced

注意事项

  • 脚本依赖 python3（3.7+，使用 datetime.fromisoformat）和 bash
  • 高级模式（--advanced）会临时修改 openclaw.json 并重启 Gateway，退出时自动恢复
  • 无 Swap 的机器上并发多 Agent 时注意内存
  • 时间戳统一为 UTC 处理，不受本地时区影响

Comments

Markdown supported