Tool / Skill 질문이
답변이 되기까지

# 이미지 처리 stage 확인 (cache-trace 활성화 필요)
OPENCLAW_CACHE_TRACE=1 OPENCLAW_CACHE_TRACE_MESSAGES=1 openclaw gateway run

# prompt:images = 이미지가 payload에 실리는 전용 stage
cat ~/.openclaw/logs/cache-trace.jsonl \
  | jq 'select(.stage=="prompt:images")'

# 비-vision 경로에서 변환 모델이 돌았는지 (media-understanding)
openclaw logs --follow --json | grep -i "media-understanding\|vision\|transcription"

# 모델이 vision 네이티브인지 확인
openclaw status --json | jq '.model'

# 미디어 생성 tool 호출 확인
cat <id>.trajectory.jsonl \
  | jq 'select(.type=="tool.call" and (.data.name | test("generate|tts|image|video"))) | .data'

# 최종 전달된 응답 + 토큰
cat <id>.trajectory.jsonl \
  | jq 'select(.type=="assistant.message") | .data'

# 전달 단계 로그 (chunk/미디어/재시도)
openclaw logs --follow --json | grep -i "deliver\|sendMessage\|resolve-media"

# memory_search 호출 이력 확인
cat <id>.trajectory.jsonl \
  | jq 'select(.type=="tool.call" and .data.name=="memory_search") | .data'

# memory 인덱스 상태
openclaw memory status --deep

# 특정 키워드 검색
openclaw memory search "날씨" --json

# 활성화: OPENCLAW_CACHE_TRACE=1 OPENCLAW_CACHE_TRACE_MESSAGES=1
#
# Stage 순서와 의미:
#  session:loaded        → JSONL에서 읽은 원본 메시지 수
#  session:raw-model-run → 모델 실행 직전 (sanitize 전)
#  session:sanitized     → sanitize + validate 완료 후
#  session:limited       → turn limit (pruning) 적용 후
#  prompt:before         → prompt 조립 직전
#  stream:context        → provider에 전송되는 최종 payload
#  cache:result          → 캐시 hit 여부와 절감 토큰
#  cache:state           → 현재 캐시 상태
#  session:after         → 응답 처리 후

# 전체 단계별 메시지 수 한 번에 보기
cat ~/.openclaw/logs/cache-trace.jsonl | jq '
  select(.stage | test("loaded|raw|sanitized|limited|stream|cache:result"))
  | "\(.stage): \(.messageCount // "N/A") msgs, cache_hit=\(.cacheHit // "N/A")"
'

#!/bin/bash
# ── OpenClaw 로그 관측 시작 스크립트 ──

# 1. gateway를 cache-trace 활성화 모드로 실행
OPENCLAW_CACHE_TRACE=1 \
OPENCLAW_CACHE_TRACE_MESSAGES=1 \
OPENCLAW_CACHE_TRACE_PROMPT=1 \
  openclaw gateway run &

# 2. 세션 ID 확인 (질문 하나 보낸 후)
openclaw sessions --json --all-agents | jq '.[0] | {sessionId, file}'

# 3. SESSION_ID 변수 설정
SESSION_ID="여기에_세션ID_입력"
TRAJ="~/.openclaw/agents/main/sessions/${SESSION_ID}.trajectory.jsonl"

# 4. 실시간 trajectory 팔로우 (터미널 1)
tail -f $TRAJ | jq '{type, ts: .ts[11:19]}'

# 5. cache-trace 팔로우 (터미널 2)
tail -f ~/.openclaw/logs/cache-trace.jsonl \
  | jq 'select(.stage | test("loaded|sanitized|limited|stream|cache:result"))
    | {stage, messageCount, cacheHit}'

# 6. 앱 로그 (터미널 3)
openclaw logs --follow --json

# 7. 실행 후 전체 분석
cat $TRAJ | jq '[{type, ts: .ts[11:19]}]'