AIエージェントの失敗、無限ループ、リソースのボトルネックを特定して解決するために設計された体系的なデバッグフレームワーク。
インストール＆ダウンロード
1. ClawHub CLI
レジストリから直接スキルをインストールする最速の方法です。
npx clawhub@latest install agent-debugger
2. 手動インストール
スキルフォルダを以下のいずれかの場所にコピーしてください
~/.openclaw/skills/ <project>/skills/ 優先順位：ワークスペース > ローカル > バンドル
3. プロンプトのインストール
このプロンプトをOpenClawにコピーするだけで、自動的にインストールされます。
Clawhubを使って agent-debugger をインストールして。Clawhubがインストールされていない場合は、先にインストールしてください（npm i -g clawhub）。
ダウンロードをご希望ですか？
ZIPアーカイブで生のスキルファイルを取得します。
Agent Debugger とは？
Agent Debugger は、AIエージェント開発に特有の課題に対処するために構築された Openclaw Skills ライブラリ内の専門ツールセットです。コンテキストオーバーフロー、レート制限、権限エラーなどの一般的な自律型エージェントの問題を診断するための構造化されたアプローチを提供します。これらのデバッグプロトコルを実装することで、開発者はエージェントの信頼性と効率を維持し、予期しないツールの失敗やロジックループから確実に回復できるようになります。
このスキルは、複雑なエージェントワークフローを構築するすべての人にとって不可欠なツールであり、診断パターンと修正のための具体的なコードスニペットの両方を提供します。推論チェーンの停滞やメモリの断片化に対処する場合でも、Agent Debugger はエージェントのパフォーマンスを安定させ、token 消費を最適化するために必要な技術的ガードレールを提供します。
Agent Debugger のユースケース
- エージェントが同じツール呼び出しや出力パターンを繰り返す無限ループの解決。
- schema の不一致、権限の欠如、または API タイムアウトによって引き起こされるツールの失敗のデバッグ。
- 長時間実行される会話におけるコンテキストオーバーフローと「context length exceeded」エラーの管理。
- プロバイダーのレート制限を処理するための指数バックオフとリクエストキューイングの実装。
- エージェントが以前の決定を見失ったり、MEMORY.md の読み込みに失敗したりするメモリ問題の修正。
Agent Debugger の仕組み
- 再現: 誤動作やエラーを誘発する正確な手順と入力を記録します。
- 分離: タスクを簡素化し、不要な Openclaw Skills を無効にし、コンテキストを最小限に抑えて特定の失敗点を見つけます。
- 診断: ログを分析し、現在の token 使用量を確認し、ツール設定を確認します。
- 修正: 反復制限の追加、リトライロジック、またはコンテキスト圧縮などの修正措置を適用します。
- 防止: 新しいガードレールでエージェントの指示を更新し、再発を防ぐために解決策をエージェントのメモリに記録します。
Agent Debugger のセットアップ
このスキルが提供するデバッグプロトコルの使用を開始するには、ワークスペースが Openclaw Skills 開発用に正しく構成されていることを確認してください。
# ワークスペース構造の確認
ls -la ~/.openclaw/workspace/
# メモリファイルが存在することを確認
touch ~/.openclaw/workspace/MEMORY.md
デバッグフェーズ中に内部推論を公開するために、エージェントを詳細思考（verbose thinking）で構成します。
{
"thinking": "verbose",
"reasoning": "on"
}
Agent Debugger のデータスキーマとタクソノミー
Agent Debugger は、エージェントエラーを分類および追跡するために構造化されたアプローチを利用します。以下は、このスキルで使用される主要なエラーマッピングです。
| エラーコード | 主な原因 | 修正戦略 |
|---|---|---|
context_length_exceeded |
過剰な履歴/ファイルデータ | 要約と切り詰め |
rate_limit_exceeded |
API 頻度制限 | バックオフとキューイング |
tool_not_found |
レジストリの不一致 | インストールとパスの確認 |
permission_denied |
サンドボックス制限 | ポリシー調整 |
invalid_parameters |
Schema 違反 | 入力検証 |
Agent Debugger の高度な機能
- 反復制限: 無限ループを自動的に遮断するために maxIterations と onLimit 動作を定義します。
- 適応型コンテキスト圧縮: コンテキストオーバーフローを防ぐために、大きなファイルの読み取りにオフセットと制限を動的に使用します。
- カスタムリトライロジック: 特に 5xx エラーやタイムアウトに対して詳細なリトライ戦略を実装します。
- 並列ツール最適化: レイテンシを削減するために、複数の読み取り操作を単一の呼び出しに結合します。
- チェックポインティング: 長時間実行されるタスク中に再開できるように、エージェントの状態を定期的に保存します。
SKILL.md
ローディング
関連するOpenclawのスキル
Protein Mining Skill
文献調査から構造解析、実験の優先順位付けまで移行する、タンパク質発見のためのエンドツーエンドの自動化パイプライン。
Baidu Hot Topics Monitor
AI agent のワークフローから直接、Baidu のリアルタイムトレンド検索、ランキング、人気指数を監視するための合理化されたツールです。
Optimacros AI モデリング & 数式エキスパート
複雑な数式、モデルアーキテクチャ、およびエンタープライズ級のアクセスセキュリティに焦点を当てた、Optimacros 開発者向けの専門 AI アシスタントです。
暗号資産リアルタイム USD チャート
8 つの主要なブロックチェーンネットワーク上の数千のトークンに対して、1秒の OHLC ティックと USD 価格を提供する高性能なリアルタイム WebSocket フィードです。
特徴*
