🧠 Как в OpenClaw устроены сессии

Если по-простому: OpenClaw хранит каждый диалог как сессию, чтобы понимать, где идёт разговор, что уже обсуждали и какую историю подтягивать дальше.

Что главное понять

sessionKey - Это логическая сессия, например:

🔵 личка
🔵 группа
🔵 канал
🔵 cron-задача

То есть sessionKey отвечает на вопрос:
“К какому разговору относится это сообщение?”

sessionId - Это конкретный файл истории, который сейчас активен.

Один и тот же sessionKey может получить новый sessionId, например:

🔵 после /reset
🔵 после долгого простоя
🔵 после ежедневного reset

Где всё хранится
OpenClaw использует два уровня хранения:

sessions.json - Здесь лежит состояние сессии:

🔵 текущий sessionId
🔵 время последней активности
🔵 настройки
🔵 счётчики токенов
🔵 служебные параметры

*.jsonl - А здесь лежит сама история разговора:

🔵 сообщения
🔵 tool calls
🔵 результаты инструментов
🔵 служебные записи

Где искать файлы

Обычно на Gateway-хосте:
~/.openclaw/agents/<agentId>/sessions/sessions.json
~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl

Что полезно запомнить новичку

🔵 sessionKey - к какому разговору относится сообщение
🔵 sessionId - какой файл истории сейчас используется
🔵 sessions.json - состояние сессии
🔵 *.jsonl - полная история переписки

Чем проверять на практике

В чате:
/status

В CLI:
openclaw status
openclaw sessions
openclaw sessions --json

Чат | Канал