Zum Hauptinhalt springen

​
Sitzungsverwaltung

OpenClaw organisiert Unterhaltungen in Sitzungen. Jede Nachricht wird an eine Sitzung weitergeleitet, je nachdem, woher sie stammt — DMs, Gruppenchats, Cron-Jobs usw.

​
So werden Nachrichten geroutet

QuelleVerhalten
DirektnachrichtenStandardmäßig gemeinsame Sitzung
GruppenchatsPro Gruppe isoliert
Räume/KanälePro Raum isoliert
Cron-JobsFrische Sitzung pro Lauf
WebhooksPro Hook isoliert

​
DM-Isolation

Standardmäßig teilen sich alle DMs eine Sitzung für Kontinuität. Das ist für Einzelbenutzer-Setups in Ordnung.
Wenn mehrere Personen Ihrem Agenten Nachrichten senden können, aktivieren Sie DM-Isolation. Andernfalls teilen sich alle Benutzer denselben Unterhaltungskontext — Alices private Nachrichten wären für Bob sichtbar.
Die Lösung: 
{
  session: {
    dmScope: "per-channel-peer", // nach Kanal + Absender isolieren
  },
}
Weitere Optionen:
  • main (Standard) — alle DMs teilen sich eine Sitzung.
  • per-peer — nach Absender isolieren (kanalübergreifend).
  • per-channel-peer — nach Kanal + Absender isolieren (empfohlen).
  • per-account-channel-peer — nach Konto + Kanal + Absender isolieren.
Wenn dieselbe Person Sie über mehrere Kanäle kontaktiert, verwenden Sie session.identityLinks, um ihre Identitäten zu verknüpfen, sodass sie eine Sitzung teilen.
Prüfen Sie Ihre Konfiguration mit openclaw security audit.

​
Sitzungslebenszyklus

Sitzungen werden wiederverwendet, bis sie ablaufen:
  • Tägliches Zurücksetzen (Standard) — neue Sitzung um 4:00 Uhr Ortszeit auf dem Gateway- Host.
  • Zurücksetzen bei Inaktivität (optional) — neue Sitzung nach einer Zeit der Inaktivität. Setzen Sie session.reset.idleMinutes.
  • Manuelles Zurücksetzen — geben Sie /new oder /reset im Chat ein. /new <model> wechselt auch das Modell.
Wenn sowohl tägliches als auch inaktivitätsbasiertes Zurücksetzen konfiguriert sind, gilt das zuerst ablaufende.

​
Wo der Status gespeichert wird

Der gesamte Sitzungsstatus gehört dem Gateway. UI-Clients fragen das Gateway nach Sitzungsdaten ab.
  • Speicher: ~/.openclaw/agents/<agentId>/sessions/sessions.json
  • Transkripte: ~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl

​
Sitzungswartung

OpenClaw begrenzt den Sitzungs-Speicher im Laufe der Zeit automatisch. Standardmäßig läuft es im Modus warn (meldet, was bereinigt würde). Setzen Sie session.maintenance.mode auf "enforce" für automatische Bereinigung: 
{
  session: {
    maintenance: {
      mode: "enforce",
      pruneAfter: "30d",
      maxEntries: 500,
    },
  },
}
Vorschau mit openclaw sessions cleanup --dry-run.

​
Sitzungen prüfen

  • openclaw status — Pfad des Sitzungsspeichers und letzte Aktivität.
  • openclaw sessions --json — alle Sitzungen (mit --active <minutes> filtern).
  • /status im Chat — Kontextnutzung, Modell und Schalter.
  • /context list — was im System-Prompt enthalten ist.

​
Weiterführende Lektüre