> ## Documentation Index > Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt > Use this file to discover all available pages before exploring further. # Sessiebeheer # Sessiebeheer OpenClaw behandelt **één direct-chat-sessie per agent** als primair. Directe chats vallen samen tot `agent::` (standaard `main`), terwijl groeps-/kanaalchats hun eigen sleutels krijgen. `session.mainKey` wordt gerespecteerd. Gebruik `session.dmScope` om te bepalen hoe **directe berichten** worden gegroepeerd: * `main` (standaard): alle DM's delen de hoofdsessie voor continuïteit. * `per-peer`: isoleer per afzender-id over kanalen heen. * `per-channel-peer`: isoleer per kanaal + afzender (aanbevolen voor inboxen met meerdere gebruikers). * `per-account-channel-peer`: isoleer per account + kanaal + afzender (aanbevolen voor inboxen met meerdere accounts). Gebruik `session.identityLinks` om provider-geprefixte peer-id's te mappen naar een canonieke identiteit, zodat dezelfde persoon één DM-sessie deelt over kanalen heen bij gebruik van `per-peer`, `per-channel-peer` of `per-account-channel-peer`. ## Veilige DM-modus (aanbevolen voor setups met meerdere gebruikers) > **Beveiligingswaarschuwing:** Als je agent DM's kan ontvangen van **meerdere personen**, overweeg sterk om de veilige DM-modus in te schakelen. Zonder deze modus delen alle gebruikers dezelfde conversatiecontext, wat privé-informatie tussen gebruikers kan lekken. **Voorbeeld van het probleem met standaardinstellingen:** * Alice (``) stuurt je agent een bericht over een privéonderwerp (bijvoorbeeld een medische afspraak) * Bob (``) stuurt je agent de vraag: "Waar hadden we het over?" * Omdat beide DM's dezelfde sessie delen, kan het model Bob antwoorden met context van Alice. **De oplossing:** Stel `dmScope` in om sessies per gebruiker te isoleren: ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} // ~/.openclaw/openclaw.json { session: { // Secure DM mode: isolate DM context per channel + sender. dmScope: "per-channel-peer", }, } ``` **Wanneer dit inschakelen:** * Je hebt koppelingsgoedkeuringen voor meer dan één afzender * Je gebruikt een DM-toegestane lijst met meerdere vermeldingen * Je stelt `dmPolicy: "open"` in * Meerdere telefoonnummers of accounts kunnen je agent berichten sturen Notities: * Standaard is `dmScope: "main"` voor continuïteit (alle DM's delen de hoofdsessie). Dit is prima voor setups met één gebruiker. * Voor inboxen met meerdere accounts op hetzelfde kanaal heeft `per-account-channel-peer` de voorkeur. * Als dezelfde persoon je via meerdere kanalen benadert, gebruik `session.identityLinks` om hun DM-sessies samen te voegen tot één canonieke identiteit. * Je kunt je DM-instellingen verifiëren met `openclaw security audit` (zie [beveiliging](/cli/security)). ## Gateway is de bron van waarheid Alle sessiestatus is **eigendom van de Gateway** (de “master” OpenClaw). UI-clients (macOS-app, WebChat, enz.) moeten de Gateway raadplegen voor sessielijsten en tokentellingen in plaats van lokale bestanden te lezen. * In **remote-modus** bevindt de relevante sessie-opslag zich op de externe Gateway-host, niet op je Mac. * Tokentellingen die in UI's worden getoond, komen uit de opslagvelden van de Gateway (`inputTokens`, `outputTokens`, `totalTokens`, `contextTokens`). Clients parsen geen JSONL-transcripten om totalen te “corrigeren”. ## Waar status leeft * Op de **Gateway-host**: * Opslagbestand: `~/.openclaw/agents//sessions/sessions.json` (per agent). * Transcripties: `~/.openclaw/agents//sessions/.jsonl` (Telegram-onderwerpsessies gebruiken `.../-topic-.jsonl`). * De opslag is een map `sessionKey -> { sessionId, updatedAt, ... }`. Het verwijderen van vermeldingen is veilig; ze worden on-demand opnieuw aangemaakt. * Groepsvermeldingen kunnen `displayName`, `channel`, `subject`, `room` en `space` bevatten om sessies in UI's te labelen. * Sessievermeldingen bevatten `origin`-metadata (label + routeringshints) zodat UI's kunnen uitleggen waar een sessie vandaan komt. * OpenClaw leest **geen** legacy Pi/Tau-sessiemappen. ## Sessie-opruiming OpenClaw trimt standaard **oude toolresultaten** uit de in-memory context vlak vóór LLM-aanroepen. Dit herschrijft de JSONL-geschiedenis **niet**. Zie [/concepts/session-pruning](/concepts/session-pruning). ## Pre-compactie geheugenflush Wanneer een sessie de automatische compactie nadert, kan OpenClaw een **stille geheugenflush** uitvoeren die het model eraan herinnert om duurzame notities naar schijf te schrijven. Dit draait alleen wanneer de werkruimte schrijfbaar is. Zie [Memory](/concepts/memory) en [Compaction](/concepts/compaction). ## Transporten → sessiesleutels mappen * Directe chats volgen `session.dmScope` (standaard `main`). * `main`: `agent::` (continuïteit over apparaten/kanalen). * Meerdere telefoonnummers en kanalen kunnen naar dezelfde agent-hoofdsleutel mappen; ze fungeren als transporten naar één conversatie. * `per-peer`: `agent::dm:`. * `per-channel-peer`: `agent:::dm:`. * `per-account-channel-peer`: `agent::::dm:` (accountId is standaard `default`). * Als `session.identityLinks` overeenkomt met een provider-geprefixte peer-id (bijvoorbeeld `telegram:123`), vervangt de canonieke sleutel ``, zodat dezelfde persoon één sessie deelt over kanalen heen. * Groepschats isoleren status: `agent:::group:` (ruimtes/kanalen gebruiken `agent:::channel:`). * Telegram-forumonderwerpen voegen `:topic:` toe aan de groeps-id voor isolatie. * Legacy `group:`-sleutels worden nog steeds herkend voor migratie. * Inkomende contexten kunnen nog `group:` gebruiken; het kanaal wordt afgeleid uit `Provider` en genormaliseerd naar de canonieke vorm `agent:::group:`. * Andere bronnen: * Cronjobs: `cron:` * Webhooks: `hook:` (tenzij expliciet door de hook ingesteld) * Node-runs: `node-` ## Levenscyclus * Resetbeleid: sessies worden hergebruikt totdat ze verlopen, en verstrijken wordt geëvalueerd bij het volgende inkomende bericht. * Dagelijkse reset: standaard **04:00 lokale tijd op de Gateway-host**. Een sessie is verouderd zodra de laatste update eerder is dan het meest recente dagelijkse resetmoment. * Inactiviteitsreset (optioneel): `idleMinutes` voegt een schuivend inactiviteitsvenster toe. Wanneer zowel dagelijkse als inactiviteitsresets zijn geconfigureerd, **dwingt degene die het eerst verloopt** een nieuwe sessie af. * Legacy alleen-inactiviteit: als je `session.idleMinutes` instelt zonder enige `session.reset`/`resetByType`-configuratie, blijft OpenClaw omwille van achterwaartse compatibiliteit in alleen-inactiviteitsmodus. * Per-type overrides (optioneel): `resetByType` laat je het beleid overschrijven voor `direct`, `group` en `thread`-sessies (thread = Slack/Discord-threads, Telegram-topics, Matrix-threads wanneer geleverd door de connector). * Overrides per kanaal (optioneel): `resetByChannel` overschrijft het resetbeleid voor een kanaal (geldt voor alle sessietypen voor dat kanaal en heeft voorrang op `reset`/`resetByType`). * Reset-triggers: exact `/new` of `/reset` (plus eventuele extra's in `resetTriggers`) starten een nieuwe sessie-id en geven de rest van het bericht door. `/new ` accepteert een model-alias, `provider/model` of providernaam (fuzzy match) om het nieuwe sessiemodel in te stellen. Als `/new` of `/reset` alleen wordt verzonden, voert OpenClaw een korte “hallo”-groetbeurt uit om de reset te bevestigen. * Handmatige reset: verwijder specifieke sleutels uit de opslag of verwijder het JSONL-transcript; het volgende bericht maakt ze opnieuw aan. * Geïsoleerde cronjobs maken per run altijd een nieuwe `sessionId` aan (geen hergebruik bij inactiviteit). ## Verzendbeleid (optioneel) Blokkeer levering voor specifieke sessietypen zonder individuele id's te hoeven vermelden. ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { session: { sendPolicy: { rules: [ { action: "deny", match: { channel: "discord", chatType: "group" } }, { action: "deny", match: { keyPrefix: "cron:" } }, ], default: "allow", }, }, } ``` Runtime-override (alleen eigenaar): * `/send on` → toestaan voor deze sessie * `/send off` → weigeren voor deze sessie * `/send inherit` → override wissen en configuratieregels gebruiken Stuur deze als zelfstandige berichten zodat ze worden geregistreerd. ## Configuratie (optioneel hernoemvoorbeeld) ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} // ~/.openclaw/openclaw.json { session: { scope: "per-sender", // groepssleutels gescheiden houden dmScope: "main", // DM-continuïteit (instellen per-channel-peer/per-account-channel-peer voor gedeelde inboxen) identityLinks: { alice: ["telegram:123456789", "discord:987654321012345678"], }, reset: { // Standaarden: mode=daily, atHour=4 (lokale tijd van de gateway-host). // Als je ook idleMinutes instelt, wint degene die het eerst verloopt. mode: "daily", atHour: 4, idleMinutes: 120, }, resetByType: { thread: { mode: "daily", atHour: 4 }, direct: { mode: "idle", idleMinutes: 240 }, group: { mode: "idle", idleMinutes: 120 }, }, resetByChannel: { discord: { mode: "idle", idleMinutes: 10080 }, }, resetTriggers: ["/new", "/reset"], store: "~/.openclaw/agents/{agentId}/sessions/sessions.json", mainKey: "main", }, } ``` ## Inspecteren * `openclaw status` — toont opslagpad en recente sessies. * `openclaw sessions --json` — dumpt elke vermelding (filter met `--active `). * `openclaw gateway call sessions.list --params '{}'` — haalt sessies op van de draaiende Gateway (gebruik `--url`/`--token` voor toegang tot een externe Gateway). * Stuur `/status` als een zelfstandig bericht in de chat om te zien of de agent bereikbaar is, hoeveel van de sessiecontext wordt gebruikt, de huidige thinking/verbose-toggles, en wanneer je WhatsApp-webgegevens voor het laatst zijn ververst (helpt bij het signaleren van herlinkbehoeften). * Stuur `/context list` of `/context detail` om te zien wat er in de systeemprompt en geïnjecteerde werkruimtebestanden staat (en de grootste contextbijdragers). * Stuur `/stop` als een zelfstandig bericht om de huidige run af te breken, wachtrijen met vervolgacties voor die sessie te wissen en alle sub-agent-runs die daarvan zijn gestart te stoppen (het antwoord bevat het gestopte aantal). * Stuur `/compact` (optionele instructies) als een zelfstandig bericht om oudere context samen te vatten en vensterruimte vrij te maken. Zie [/concepts/compaction](/concepts/compaction). * JSONL-transcripten kunnen direct worden geopend om volledige beurten te bekijken. ## Tips * Houd de primaire sleutel gereserveerd voor 1:1-verkeer; laat groepen hun eigen sleutels behouden. * Verwijder bij geautomatiseerde opschoning afzonderlijke sleutels in plaats van de hele opslag om context elders te behouden. ## Metadata van sessieherkomst Elke sessievermelding registreert waar deze vandaan komt (best-effort) in `origin`: * `label`: menselijk label (opgelost uit conversatielabel + groepsonderwerp/kanaal) * `provider`: genormaliseerde kanaal-id (inclusief extensies) * `from`/`to`: ruwe routerings-id's uit de inkomende envelop * `accountId`: provider-account-id (bij meerdere accounts) * `threadId`: thread-/onderwerp-id wanneer het kanaal dit ondersteunt De herkomstvelden worden gevuld voor directe berichten, kanalen en groepen. Als een connector alleen de afleverroutering bijwerkt (bijvoorbeeld om een DM-hoofdsessie vers te houden), moet hij alsnog inkomende context leveren zodat de sessie haar verklarende metadata behoudt. Extensies kunnen dit doen door `ConversationLabel`, `GroupSubject`, `GroupChannel`, `GroupSpace` en `SenderName` in de inkomende context te sturen en `recordSessionMetaFromInbound` aan te roepen (of dezelfde context door te geven aan `updateLastRoute`).