session-logs

セッション JSONL ファイルに保存されている完全な会話履歴を検索します。ユーザーが過去の会話や親の会話、メモリファイルにない履歴コンテキストについて言及する場合に使用してください。

トリガー

ユーザーが過去のチャット、親の会話、または履歴コンテキストについて質問する場合にこのスキルを使用してください。

場所

セッションログはアクティブな状態ディレクトリの下に配置されます: $OPENCLAW_STATE_DIR/agents/<agentId>/sessions/ (デフォルト: ~/.openclaw/agents/<agentId>/sessions/) システムプロンプトの Runtime 行から agent=<id> の値を使用してください。

• sessions.json - セッションキーをセッション ID にマッピングするインデックス
• <session-id>.jsonl - セッションごとの完全な会話トランスクリプト

構造

各 .jsonl ファイルには以下のメッセージが含まれます:

• type: "session" (メタデータ) または "message"
• timestamp: ISO タイムスタンプ
• message.role: "user"、"assistant"、または "toolResult"
• message.content[]: テキスト、思考、またはツール呼び出し (type=="text" をフィルタして人間が読める内容を取得)
• message.usage.cost.total: レスポンスごとのコスト

一般的なクエリ

すべてのセッションを日付とサイズでリスト表示

AGENT_ID="<agentId>"
SESSION_DIR="${OPENCLAW_STATE_DIR:-$HOME/.openclaw}/agents/$AGENT_ID/sessions"
for f in "$SESSION_DIR"/*.jsonl; do
  date=$(head -1 "$f" | jq -r '.timestamp' | cut -dT -f1)
  size=$(ls -lh "$f" | awk '{print $5}')
  echo "$date $size $(basename $f)"
done | sort -r

特定の日のセッションを検索

AGENT_ID="<agentId>"
SESSION_DIR="${OPENCLAW_STATE_DIR:-$HOME/.openclaw}/agents/$AGENT_ID/sessions"
for f in "$SESSION_DIR"/*.jsonl; do
  head -1 "$f" | jq -r '.timestamp' | grep -q "2026-01-06" && echo "$f"
done

セッションからユーザーメッセージを抽出

jq -r 'select(.message.role == "user") | .message.content[]? | select(.type == "text") | .text' <session>.jsonl

アシスタント応答内のキーワードを検索

jq -r 'select(.message.role == "assistant") | .message.content[]? | select(.type == "text") | .text' <session>.jsonl | rg -i "keyword"

セッションの総コストを取得

jq -s '[.[] | .message.usage.cost.total // 0] | add' <session>.jsonl

日ごとのコスト集計

AGENT_ID="<agentId>"
SESSION_DIR="${OPENCLAW_STATE_DIR:-$HOME/.openclaw}/agents/$AGENT_ID/sessions"
for f in "$SESSION_DIR"/*.jsonl; do
  date=$(head -1 "$f" | jq -r '.timestamp' | cut -dT -f1)
  cost=$(jq -s '[.[] | .message.usage.cost.total // 0] | add' "$f")
  echo "$date $cost"
done | awk '{a[$1]+=$2} END {for(d in a) print d, "$"a[d]}' | sort -r

セッション内のメッセージとトークンをカウント

jq -s '{
  messages: length,
  user: [.[] | select(.message.role == "user")] | length,
  assistant: [.[] | select(.message.role == "assistant")] | length,
  first: .[0].timestamp,
  last: .[-1].timestamp
}' <session>.jsonl

ツール使用の内訳

jq -r '.message.content[]? | select(.type == "toolCall") | .name' <session>.jsonl | sort | uniq -c | sort -rn

すべてのセッション内でフレーズを検索

AGENT_ID="<agentId>"
SESSION_DIR="${OPENCLAW_STATE_DIR:-$HOME/.openclaw}/agents/$AGENT_ID/sessions"
rg -l "phrase" "$SESSION_DIR"/*.jsonl

ヒント

• セッションは追加専用の JSONL です (1 行に 1 つの JSON オブジェクト)
• 大きなセッションは数 MB 可能 - サンプリングには head/tail を使用
• sessions.json インデックスはチャットプロバイダー (discord、whatsapp など) をセッション ID にマッピングします
• 削除されたセッションには .deleted.<timestamp> サフィックスがあります

高速テキストのみヒント (ノイズが少ない)

AGENT_ID="<agentId>"
SESSION_DIR="${OPENCLAW_STATE_DIR:-$HOME/.openclaw}/agents/$AGENT_ID/sessions"
jq -r 'select(.type=="message") | .message.content[]? | select(.type=="text") | .text' "$SESSION_DIR"/<id>.jsonl | rg 'keyword'