session-logs

• 사용자가 "지난주에 우리가 무슨 얘기 했지?"라고 묻거나 현재 메모리에 없는 이전 대화를 참조하는 경우.
• 세션 비용을 계산하거나, 메시지 수를 세거나, 과거 채팅 전반에 걸친 도구 사용 현황을 요약해야 하는 경우.
• 모든 과거 세션에서 특정 키워드나 문구를 빠르게 검색하고 싶은 경우.
• sessions.json 인덱스를 사용하여 날짜, 크기 또는 제공자(Discord, WhatsApp 등)별로 세션을 식별해야 하는 경우.

• 필요한 컨텍스트는 이미 현재 대화 창이나 메모리 파일에서 사용 가능합니다 — 파일시스템에 접근할 필요가 없습니다.
• ~/.openclaw/agents/ 세션 스토리지가 존재하지 않거나 접근할 수 없는 환경에서 작업 중입니다.

rg (ripgrep)를 사용하여 단일 명령으로 모든 세션 JSONL 파일에서 특정 문구나 키워드를 검색하세요. 각 파일을 수동으로 읽지 않고도 관련 내용이 포함된 세션을 빠르게 찾을 수 있습니다.

.message.role 및 .message.content[].type 필드에서 jq 셀렉터를 사용하여 사용자 메시지, 어시스턴트 응답, 도구 호출 또는 thinking 블록을 독립적으로 추출합니다. 도구 결과와 같은 노이즈를 자동으로 필터링합니다.

세션 전체 또는 모든 세션에 걸쳐 일별로 message.usage.cost.total을 집계하여 비용 요약을 생성합니다. 또한 메시지 수 계산, 세션 지속 시간 산출, 도구 사용 빈도별 분류도 지원합니다.

날짜 및 파일 크기 순으로 정렬된 모든 세션을 나열하거나, 특정 날짜의 세션을 찾거나, sessions.json을 참조하여 채팅 제공업체(Discord, WhatsApp 등)를 세션 ID에 매핑합니다.

세션은 추가 전용(append-only) JSONL 파일로, 크기가 수 MB까지 커질 수 있습니다. session-logs 스킬의 쿼리 패턴에는 head/tail 샘플링 팁과 파일 전체를 불필요하게 메모리에 로드하지 않기 위한 스트리밍 jq 사용법이 포함되어 있습니다.

사용자가 "지난달에 X에 대해 이야기했던 거 기억해?"라고 말할 때, 에이전트는 이 스킬을 사용하여 날짜나 키워드로 session-logs 파일을 검색하고, 해당 내용이 더 이상 활성 컨텍스트 창에 없더라도 관련 대화 내용을 찾아 제공합니다.

개발자는 각 대화에 드는 비용을 파악하고자 합니다. 이 스킬은 세션별 cost.total을 집계하고 결과를 일별로 그룹화하여, 전체 에이전트 기록에 걸친 읽기 쉬운 비용 분석 결과를 제공합니다.

운영자는 에이전트가 가장 자주 호출하는 도구가 무엇인지 파악하고자 합니다. 이 스킬은 session-logs에서 toolCall 항목을 추출하고, 이를 집계한 후 순위를 매깁니다. 이는 에이전트 동작을 디버깅하거나 최적화하는 데 유용합니다.

사용자가 특정 주제(예: 프로젝트 이름, 결정 사항)가 이전에 논의된 적이 있는지 묻습니다. 에이전트는 모든 JSONL 파일에 대해 ripgrep 검색을 실행하고, 추가 탐색을 위해 일치하는 session-logs 경로를 반환합니다.