byted-openclaw-diag

OpenClaw 診断ツール

コマンドモード

ユーザーが /diag コマンドを送信したら、追加の説明をせずにスクリプトを直接実行します：

ユーザー入力	実行コマンド	説明
/diag	-s	今日の概要（デフォルト）
/diag full	(无-s)	完全レポート（Run の詳細＋エラー一覧を含む）
/diag full -l 3	-l 3	直近 3 件の Run の完全な詳細
/diag -a waicode	-s -a waicode	指定エージェントの概要
/diag -a main full	-a main	指定エージェントの完全レポート
/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 の詳細＋タイムライン＋エラー一覧を含む
エージェントの絞り込み	-a <name>	指定したエージェントのみ表示
件数の制限	-l N	直近 N 件の Run のみ表示
日付の指定	YYYY-MM-DD	デフォルトは今日

パラメーターは組み合わせて使用できます：-s -a main、-l 3 -a wairesearch。

リアルタイム追跡（-f）と高度なモード（--advanced）は SSH ターミナルで実行する必要があります。 詳しくは references/advanced-mode.md を参照してください。

データソース

スクリプトには 2 種類のデータソースがあり、自動で切り替わります：

データソース	パス	設定	精度
Debug ログ	/tmp/openclaw/openclaw-YYYY-MM-DD.log	diagnostics.enabled: true	正確な Run 境界
Session ファイル	~/.openclaw/agents/*/sessions/*.jsonl	設定不要	仮想 Run（メッセージのタイムスタンプから推定）

debug ログがない場合は、自動的に session モードに切り替わります。推論時間、Token、ツールの統計などの主要指標は引き続き正確です。

出力内容

概要統計

• モデルの呼び出し回数、平均推論レイテンシ、Token スループット
• ツールの呼び出し回数、成功率、合計所要時間
• Thinking の統計（回数、平均深度）
• エージェントごとのアクティビティ分布

Run の詳細（概要モード以外）

• 各 Run のタイムライン（推論区間＋ツール呼び出し区間）
• 推論時間、出力 Token、スループット
• ツール呼び出しパラメーターの概要

エラー一覧

• 直近 20 件のエラーを時系列の降順で表示

使用ガイド

日常の確認

# 快速了解今天的运行概况
bash scripts/byted-openclaw-diag.sh -s

パフォーマンスの調査

# 查看某天详细 Run 数据，找到慢查询
bash scripts/byted-openclaw-diag.sh 2026-03-19 -l 10

特定のエージェントの分析

# 只看 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 のないマシンで複数のエージェントを並行実行する場合は、メモリーに注意してください
• タイムスタンプはすべて UTC で処理されるため、ローカルのタイムゾーンの影響を受けません