Zarządzanie sesjami w OpenClaw — routing, izolacja i cykl życia

Czym są sesje w OpenClaw?

OpenClaw organizuje konwersacje w sesje. Routing wiadomości zależy od ich źródła — wiadomości prywatne, czaty grupowe, pokoje/kanały, zadania cron i webhooki trafiają do różnych sesji.

Routing wiadomości według źródła

• Wiadomości prywatne (DM) — domyślnie współdzielona sesja
• Czaty grupowe — izolacja per grupa
• Pokoje / kanały — izolacja per pokój
• Zadania cron — świeża sesja przy każdym uruchomieniu
• Webhooki — izolacja per hook

Izolacja wiadomości prywatnych

Bez odpowiedniej konfiguracji wszyscy użytkownicy dzielą ten sam kontekst konwersacji — prywatne wiadomości Alicji byłyby widoczne dla Boba. Dlatego zalecane jest ustawienie izolacji per-channel-peer:

• main — domyślna, współdzielona sesja (brak izolacji)
• per-peer — izolacja per nadawca
• per-channel-peer — izolacja per kanał i nadawca (zalecane)
• per-account-channel-peer — izolacja per konto, kanał i nadawca

Opcja session.identityLinks pozwala łączyć tożsamości tego samego użytkownika między kanałami.

Cykl życia sesji

Sesje resetują się na kilka sposobów:

• Codzienny reset — domyślnie o 4:00 rano czasu lokalnego
• Reset po bezczynności — po konfigurowalnym okresie nieaktywności
• Ręczny reset — poleceniami /new lub /reset

Przechowywanie sesji

Dane sesji zapisywane są w katalogu ~/.openclaw/agents/<agentId>/sessions/:

• sessions.json — rejestr sesji
• <sessionId>.jsonl — indywidualne transkrypty sesji

Konserwacja i czyszczenie

Automatyczne czyszczenie można skonfigurować z parametrami przycinania (domyślnie: 30 dni retencji, maksymalnie 500 wpisów).

Polecenia inspekcji

openclaw status            # Ogólny status
openclaw sessions --json   # Lista sesji w formacie JSON
/status                    # Status w czacie
/context list              # Lista kontekstu