session-logs

• 使用者詢問「我們上週聊了什麼？」或提及當前記憶中沒有的先前對話。
• 您需要計算會話費用、統計訊息數量，或彙整歷史對話中的工具使用情況。
• 您想在所有過去的會話中快速搜尋特定關鍵字或詞語。
• 您需要使用 sessions.json 索引，依日期、大小或平台（Discord、WhatsApp 等）來識別會話。

• 您所需的上下文已可從目前的對話視窗或記憶檔案中取得——無需存取檔案系統。
• 您正在運作的環境中，~/.openclaw/agents/ 工作階段儲存空間不存在或無法存取。

使用 rg（ripgrep）以單一指令在所有工作階段的 JSONL 檔案中搜尋特定詞句或關鍵字。無需逐一手動閱讀每個檔案，即可快速找出哪些工作階段包含相關內容。

透過 jq 選擇器針對 .message.role 與 .message.content[].type 欄位，獨立擷取使用者訊息、助理回應、工具呼叫或思考區塊。自動過濾掉工具結果等雜訊。

跨單一 session 或依日期跨所有 session 彙總 message.usage.cost.total，以產生費用摘要。同時支援計算訊息數量、計算 session 持續時間，以及依使用頻率分析工具用量。

列出所有依日期和檔案大小排序的工作階段、尋找特定日期的工作階段，或查閱 sessions.json 以將聊天服務提供商（Discord、WhatsApp 等）對應至工作階段 ID。

Sessions 是僅附加模式的 JSONL 檔案，可能會成長至數 MB。session-logs 的查詢模式包含 head/tail 取樣技巧，以及串流式 jq 用法，以避免不必要地將整個檔案載入記憶體。

當使用者說「還記得我們上個月討論過 X 嗎？」時，代理程式會使用此技能，透過日期或關鍵字搜尋 session-logs 檔案，並將相關的對話內容呈現出來，即使該內容已不在目前的活躍上下文視窗中亦然。

開發人員想了解每次對話所產生的費用。此技能透過 session-logs 彙總每個會話的 cost.total，並依日期分組結果，針對整個代理歷史記錄產生易於閱讀的費用明細。

一位操作者想了解代理最常呼叫哪些工具。此技能從 session-logs 中提取 toolCall 項目，對其進行計數並排名——有助於除錯或優化代理行為。

使用者詢問某個特定主題（例如專案名稱、某項決策）是否曾被討論過。代理程式會對所有 JSONL 檔案執行 ripgrep 搜尋，並回傳符合條件的 session-logs 路徑，以供進一步探索。