openclaw sessions

저장된 대화 세션을 나열합니다.

세션 목록은 채널/공급자의 활성 상태를 확인하는 기능이 아닙니다. 세션 저장소에 영구 저장된 대화 행을 표시합니다. 비활성 상태인 Discord, Slack, Telegram 또는 기타 채널은 메시지가 처리되어 새 세션 행이 생성되기 전에도 성공적으로 다시 연결될 수 있습니다. 실시간 채널 연결 상태가 필요하면 openclaw channels status --probe, openclaw status --deep 또는 openclaw health --verbose을(를) 사용하십시오.

openclaw sessionsopenclaw sessions --agent workopenclaw sessions --all-agentsopenclaw sessions --active 120openclaw sessions --limit 25openclaw sessions --store ./tmp/sessions.jsonopenclaw sessions --json

플래그:

openclaw sessions 및 Gateway sessions.list RPC는 대규모 장기 저장소가 CLI 프로세스나 Gateway 이벤트 루프를 독점하지 못하도록 기본적으로 제한됩니다. CLI는 기본적으로 최신 세션 100개를 반환합니다. 더 작거나 큰 범위를 지정하려면 --limit <n>을(를), 의도적으로 전체 저장소가 필요할 때는 --limit all을(를) 전달하십시오. 호출자가 더 많은 행이 있음을 표시해야 하는 경우 JSON 응답에는 totalCount, limitApplied 및 hasMore이(가) 포함됩니다.

RPC 클라이언트는 configuredAgentsOnly: true을(를) 전달하여 광범위한 통합 검색 소스를 유지하면서 현재 구성에 있는 에이전트의 행만 반환할 수 있습니다. Control UI는 삭제되었거나 디스크에만 존재하는 에이전트 저장소가 Sessions 보기에 다시 나타나지 않도록 기본적으로 이 모드를 사용합니다.

--all-agents은(는) 구성된 에이전트 저장소를 읽습니다. Gateway 및 ACP 세션 검색의 범위는 더 넓습니다. 구성된 에이전트 루트 또는 템플릿화된 session.store 루트에서 확인된 SQLite 저장소도 포함합니다. 레거시 선택기 경로는 에이전트 루트 내부로 확인되어야 하며, 심볼릭 링크와 루트 외부 경로는 건너뜁니다.

openclaw sessions --all-agents --json:

{  "path": null,  "stores": [    { "agentId": "main", "path": "/home/user/.openclaw/agents/main/sessions/sessions.json" },    { "agentId": "work", "path": "/home/user/.openclaw/agents/work/sessions/sessions.json" }  ],  "allAgents": true,  "count": 2,  "totalCount": 2,  "limitApplied": 100,  "hasMore": false,  "activeMinutes": null,  "sessions": [    { "agentId": "main", "key": "agent:main:main", "model": "openai/gpt-5.6-sol" },    { "agentId": "work", "key": "agent:work:main", "model": "anthropic/claude-sonnet-4-6" }  ]}

궤적 진행 상황 추적

openclaw sessions tailopenclaw sessions tail --followopenclaw sessions tail --session-key "agent:main:telegram:direct:123" --tail 25openclaw sessions --agent work tail --followopenclaw sessions --all-agents tail --follow

openclaw sessions tail은(는) 최근 런타임 궤적 이벤트를 간결한 진행 상황 행으로 렌더링합니다. --session-key이(가) 없으면 먼저 실행 중인 세션을 추적한 다음 가장 최근에 저장된 세션을 추적합니다. --tail <count>은(는) 팔로우 모드 전에 출력할 기존 이벤트의 수를 제어합니다. 기본값은 80이며, 0은(는) 현재 끝에서 시작합니다. --follow은(는) 선택한 SQLite 기반 세션 또는 명시적 레거시 궤적 파일을 계속 감시합니다.

진행 상황 보기는 의도적으로 보수적으로 작동합니다. 프롬프트 텍스트, 도구 인수 및 도구 결과 본문은 출력하지 않습니다. 도구 호출에는 {...redacted...}과(와) 함께 도구 이름이 표시되고, 도구 결과에는 ok, error 또는 done 같은 상태가 표시됩니다. 모델 완료 행에는 공급자/모델 및 종료 상태가 표시됩니다.

궤적 번들 내보내기

openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --workspace .openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --output bug-123 --json

소유자가 실행 요청을 승인한 후 /export-trajectory 슬래시 명령이 사용하는 명령 경로입니다. 출력 디렉터리는 항상 선택한 작업 공간 아래의 .openclaw/trajectory-exports/ 내부로 확인됩니다.

정리 유지 관리

다음 쓰기 주기를 기다리지 않고 지금 유지 관리를 실행합니다.

openclaw sessions cleanup --dry-runopenclaw sessions cleanup --agent work --dry-runopenclaw sessions cleanup --all-agents --dry-runopenclaw sessions cleanup --enforceopenclaw sessions cleanup --enforce --active-key "agent:main:telegram:direct:123"openclaw sessions cleanup --dry-run --fix-dm-scopeopenclaw sessions cleanup --json

openclaw sessions cleanup은(는) 구성의 session.maintenance 설정을 사용합니다 (구성 참조).

• 범위 참고: openclaw sessions cleanup은(는) 세션 저장소, 트랜스크립트, 궤적 행 및 레거시 궤적 사이드카를 유지 관리합니다. 작업별로 최신 2000개 행을 자동으로 유지하는 Cron 실행 기록은 정리하지 않습니다 (Cron 구성).
• 정리 작업은 참조되지 않는 레거시/보관 트랜스크립트 아티팩트, Compaction 체크포인트 및 session.maintenance.pruneAfter보다 오래된 궤적 사이드카도 정리합니다. SQLite 세션 행에서 계속 참조되는 아티팩트는 보존됩니다.
• 정리 작업은 수명이 짧은 Gateway 모델 실행 프로브 정리를 modelRunPruned(으)로 별도 보고합니다. 이는 agent:*:explicit:model-run-<uuid> 형식의 엄격하고 명시적인 키에만 일치합니다. 보존 기간은 고정된 24h이며 압력에 따라 실행됩니다. 세션 항목 유지 관리/용량 압력에 도달한 경우에만 오래된 프로브 행을 제거합니다. 실행 시 모델 실행 정리는 전체 오래된 항목 정리 및 용량 제한보다 먼저 수행됩니다.

플래그:

Gateway에 연결할 수 있으면 구성된 에이전트 저장소에 대한 비시험 실행 정리는 Gateway를 통해 전송되어 런타임 트래픽과 동일한 세션 저장소 작성기를 공유합니다. 레거시 저장소 선택기를 명시적으로 오프라인 복구하려면 --store <path>을(를) 사용하십시오.

openclaw sessions cleanup --all-agents --dry-run --json:

{  "allAgents": true,  "mode": "warn",  "dryRun": true,  "stores": [    {      "agentId": "main",      "storePath": "/home/user/.openclaw/agents/main/sessions/sessions.json",      "beforeCount": 120,      "afterCount": 80,      "missing": 0,      "dmScopeRetired": 0,      "pruned": 40,      "capped": 0    },    {      "agentId": "work",      "storePath": "/home/user/.openclaw/agents/work/sessions/sessions.json",      "beforeCount": 18,      "afterCount": 18,      "missing": 0,      "dmScopeRetired": 0,      "pruned": 0,      "capped": 0    }  ]}

세션 압축

교착 상태이거나 과도하게 큰 세션의 컨텍스트 예산을 회수합니다. openclaw sessions compact <key>은(는) sessions.compact Gateway RPC의 일급 래퍼이며 실행 중인 Gateway가 필요합니다.

openclaw sessions compact "agent:main:main"openclaw sessions compact "agent:main:main" --max-lines 200openclaw sessions compact "agent:work:main" --agent work --json

• --max-lines이(가) 없으면 Gateway가 LLM을 사용하여 트랜스크립트를 요약합니다. CLI는 기본적으로 클라이언트 기한을 적용하지 않으며, 구성된 Compaction 수명 주기는 Gateway가 관리합니다.
• --max-lines <n>을(를) 사용하면 마지막 n개 트랜스크립트 행으로 잘라내고 이전 트랜스크립트를 .bak 사이드카로 보관합니다.
• --agent <id>: 세션을 소유한 에이전트이며, global 키에 필요합니다.
• --url / --token / --password: Gateway 연결 재정의입니다.
• --timeout <ms>: 선택적 클라이언트 측 RPC 제한 시간(밀리초)입니다.
• --json: 원시 RPC 페이로드를 출력합니다.

Gateway가 Compaction 실패를 보고하거나 연결할 수 없는 경우 명령은 0이 아닌 값으로 종료되므로, Cron과 스크립트가 조용히 아무 작업도 수행하지 않은 것을 성공으로 오인하지 않습니다.

sessions.compact RPC

openclaw gateway call sessions.compact --params '<json>'이 허용하는 항목은 다음과 같습니다.

LLM 요약 응답 예시:

{  "ok": true,  "key": "agent:main:main",  "compacted": true,  "result": { "tokensBefore": 243868, "tokensAfter": 34941 }}

잘라내기 응답 예시(--max-lines 200):

{  "ok": true,  "key": "agent:main:main",  "compacted": true,  "archived": "/home/user/.openclaw/agents/main/sessions/transcripts/<id>.jsonl.bak",  "kept": 200}

관련 항목

• 세션 구성
• 세션 관리
• Compaction
• CLI 참조