openclaw sessions

Opgeslagen gesprekssessies weergeven.

Sessielijsten zijn geen controles van de bereikbaarheid van kanalen/providers. Ze tonen persistente gespreksrijen uit sessieopslagen. Een rustig Discord-, Slack-, Telegram- of ander kanaal kan opnieuw verbinding maken zonder een nieuwe sessierij aan te maken totdat een bericht wordt verwerkt. Gebruik openclaw channels status --probe, openclaw status --deep of openclaw health --verbose wanneer je actuele kanaalconnectiviteit nodig hebt.

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

Vlaggen:

openclaw sessions en de Gateway-sessions.list-RPC zijn standaard begrensd, zodat grote, lang bestaande opslagen het CLI-proces of de Gateway- eventlus niet kunnen monopoliseren. De CLI retourneert standaard de nieuwste 100 sessies; geef --limit <n> door voor een kleiner/groter venster of --limit all wanneer je bewust de volledige opslag nodig hebt. JSON-antwoorden bevatten totalCount, limitApplied en hasMore wanneer aanroepers moeten aangeven dat er meer rijen bestaan.

RPC-clients kunnen configuredAgentsOnly: true doorgeven om de brede gecombineerde detectiebron te behouden, maar alleen rijen te retourneren voor agents die momenteel in de configuratie staan. Control UI gebruikt die modus standaard, zodat verwijderde agentopslagen of agentopslagen die alleen op schijf staan niet opnieuw in de sessieweergave verschijnen.

--all-agents leest geconfigureerde agentopslagen. Sessiedetectie door Gateway en ACP is breder: deze omvat ook SQLite-opslagen die zijn afgeleid van geconfigureerde agenthoofdmappen of een gesjabloneerde session.store-hoofdmap. Verouderde selectorpaden moeten binnen de agenthoofdmap worden herleid; symbolische koppelingen en paden buiten de hoofdmap worden overgeslagen.

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" }  ]}

Voortgang van het traject volgen

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 geeft recente runtime-trajectgebeurtenissen weer als compacte voortgangsregels. Zonder --session-key volgt het eerst actieve sessies en vervolgens de laatst opgeslagen sessie. --tail <count> bepaalt hoeveel bestaande gebeurtenissen worden afgedrukt voordat de volgmodus begint; standaard 80, en 0 begint bij het huidige einde. --follow blijft de geselecteerde door SQLite ondersteunde sessie of een expliciet verouderd trajectbestand volgen.

De voortgangsweergave is bewust terughoudend: prompttekst, toolargumenten en de inhoud van toolresultaten worden niet afgedrukt. Toolaanroepen tonen de toolnaam met {...redacted...}; toolresultaten tonen een status zoals ok, error of done; regels voor modelvoltooiing tonen de provider/het model en de eindstatus.

Een trajectbundel exporteren

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

Dit is het commandopad dat wordt gebruikt door de slashopdracht /export-trajectory nadat de eigenaar het uitvoeringsverzoek heeft goedgekeurd. De uitvoermap wordt altijd herleid binnen .openclaw/trajectory-exports/ onder de geselecteerde werkruimte.

Opschoningsonderhoud

Voer het onderhoud nu uit in plaats van op de volgende schrijfcyclus te wachten:

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 gebruikt de session.maintenance-instellingen uit de configuratie (Configuratiereferentie):

• Opmerking over het bereik: openclaw sessions cleanup onderhoudt sessieopslagen, transcripties, trajectrijen en verouderde trajectzijbestanden. Het snoeit de uitvoeringsgeschiedenis van Cron niet; daarvan worden automatisch de nieuwste 2000 rijen per taak bewaard (Cron-configuratie).
• Bij het opschonen worden ook niet-gerefereerde verouderde/gearchiveerde transcriptartefacten, Compaction-controlepunten en trajectzijbestanden ouder dan session.maintenance.pruneAfter gesnoeid; artefacten waarnaar nog wordt verwezen door SQLite- sessierijen blijven behouden.
• Bij het opschonen wordt het verwijderen van kortstondige Gateway-probes voor modeluitvoeringen afzonderlijk gerapporteerd als modelRunPruned. Dit komt alleen overeen met strikte expliciete sleutels met de vorm agent:*:explicit:model-run-<uuid>. De bewaartermijn is een vaste 24h en is afhankelijk van druk: verouderde proberijen worden alleen verwijderd wanneer de onderhouds-/capaciteitsdruk voor sessie-items is bereikt. Wanneer dit wordt uitgevoerd, vindt het opschonen van modeluitvoeringen plaats vóór de algemene opschoning van verouderde gegevens en de capaciteitsbegrenzing.

Vlaggen:

Wanneer een Gateway bereikbaar is, wordt een opschoning die geen proefuitvoering is voor geconfigureerde agentopslagen via de Gateway verzonden, zodat deze dezelfde schrijver voor sessieopslag gebruikt als het runtime- verkeer. Gebruik --store <path> voor expliciet offline herstel van een verouderde opslagselector.

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    }  ]}

Een sessie compact maken

Maak contextbudget vrij voor een vastgelopen of te grote sessie. openclaw sessions compact <key> is de volwaardige wrapper rond de Gateway-RPC sessions.compact en vereist een actieve Gateway.

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

• Zonder --max-lines vat het Gateway-LLM het transcript samen. De CLI stelt standaard geen clientdeadline in; de Gateway beheert de geconfigureerde Compaction-levenscyclus.
• Met --max-lines <n> wordt het afgekapt tot de laatste n transcriptregels en wordt het eerdere transcript gearchiveerd als een .bak-zijbestand.
• --agent <id>: agent die eigenaar is van de sessie; vereist voor global-sleutels.
• --url / --token / --password: overschrijvingen voor de Gateway-verbinding.
• --timeout <ms>: optionele RPC-time-out aan clientzijde in milliseconden.
• --json: de onbewerkte RPC-payload afdrukken.

De opdracht wordt afgesloten met een niet-nulstatus wanneer de Gateway een mislukte Compaction meldt of onbereikbaar is, zodat crons en scripts een stille no-op nooit voor succes aanzien.

sessions.compact-RPC

openclaw gateway call sessions.compact --params '<json>' accepteert:

Voorbeeldrespons voor samenvatting door het LLM:

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

Voorbeeldrespons voor inkorten (--max-lines 200):

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

Gerelateerd

• Sessieconfiguratie
• Sessiebeheer
• Compaction
• CLI-referentie