session-logs

• ユーザーが「先週何を話しましたか？」と尋ねたり、現在のメモリにない以前の会話を参照したりする場合。
• セッションのコストを計算したり、メッセージを数えたり、過去のチャット全体でのツール使用状況を要約したりする必要がある場合。
• 過去のすべてのセッションから特定のキーワードやフレーズをすばやく検索したい場合。
• sessions.json インデックスを使用して、日付、サイズ、またはプロバイダー（Discord、WhatsApp など）でセッションを識別する必要がある場合。

• 必要なコンテキストは、現在の会話ウィンドウまたはメモリファイルにすでに存在しています。ファイルシステムにアクセスする必要はありません。
• あなたは ~/.openclaw/agents/ のセッションストレージが存在しないか、アクセスできない環境で作業しています。

rg（ripgrep）を使って、すべてのセッションJSONLファイルを単一のコマンドでフレーズやキーワード検索できます。各ファイルを手動で読むことなく、関連するコンテンツを含むセッションを素早く特定できます。

.message.role および .message.content[].type フィールドに対して jq セレクターを使用することで、ユーザーメッセージ、アシスタントの応答、ツール呼び出し、または思考ブロックを個別に抽出できます。ツール結果のようなノイズは自動的にフィルタリングされます。

セッション全体または全セッションを日別に集計して、message.usage.cost.total をまとめることでコストサマリーを作成します。また、メッセージ数のカウント、セッション時間の計算、ツール使用状況の頻度別内訳にも対応しています。

日付やファイルサイズで並べ替えたすべてのセッションを一覧表示したり、特定の日のセッションを検索したり、sessions.json を参照してチャットプロバイダー（Discord、WhatsApp など）をセッション ID にマッピングしたりできます。

セッションは追記専用のJSONLファイルであり、数MBに達することがあります。session-logsのクエリパターンには、head/tailによるサンプリングのヒントや、ファイル全体を不必要にメモリに読み込むことを避けるためのストリーミングjqの使い方が含まれています。

ユーザーが「先月Xについて話したこと、覚えてる？」と言ったとき、エージェントはこのスキルを使って日付やキーワードでsession-logsファイルを検索し、たとえアクティブなコンテキストウィンドウに残っていなくても、関連するやり取りを見つけ出します。

開発者は、各会話にどれくらいのコストがかかっているかを把握したいと考えています。このスキルは、セッションごとに cost.total を集計し、結果を日別にグループ化することで、エージェント履歴全体にわたる読みやすいコスト内訳を生成します。

オペレーターは、エージェントが最も頻繁に呼び出すツールを把握したいと考えています。このスキルは、session-logs からの toolCall エントリを抽出し、集計してランキングを作成します。エージェントの動作のデバッグや最適化に役立ちます。

ユーザーが特定のトピック（例：プロジェクト名、意思決定の内容）について、過去に話し合われたことがあるかどうかを尋ねます。エージェントはすべての JSONL ファイルに対して ripgrep 検索を実行し、詳細な調査のためにマッチしたセッションのパスを返します。