openclaw sessions

Перелік збережених сеансів розмов.

Списки сеансів не є перевірками доступності каналів або провайдерів. Вони показують збережені рядки розмов зі сховищ сеансів. Неактивний канал Discord, Slack, Telegram або інший канал може успішно повторно підключитися без створення нового рядка сеансу, доки не буде оброблено повідомлення. Використовуйте openclaw channels status --probe, openclaw status --deep або openclaw health --verbose, коли потрібно перевірити поточне підключення каналу.

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

Прапорці:

openclaw sessions і RPC Gateway sessions.list типово мають обмеження, щоб великі довготривалі сховища не могли монополізувати процес CLI або цикл подій Gateway. CLI типово повертає 100 найновіших сеансів; передайте --limit <n> для меншого чи більшого діапазону або --limit all, якщо навмисно потрібне повне сховище. Відповіді JSON містять totalCount, limitApplied і hasMore, щоб клієнти могли показати наявність додаткових рядків.

Клієнти RPC можуть передати configuredAgentsOnly: true, щоб зберегти широке об’єднане джерело виявлення, але повернути лише рядки агентів, які наразі присутні в конфігурації. Control UI типово використовує цей режим, щоб сховища видалених агентів або агентів, наявних лише на диску, не з’являлися повторно в поданні сеансів.

--all-agents читає налаштовані сховища агентів. Виявлення сеансів Gateway і ACP ширше: воно також охоплює сховища SQLite, визначені з налаштованих кореневих каталогів агентів або шаблонного кореня session.store. Шляхи застарілих селекторів мають визначатися в межах кореневого каталогу агента; символічні посилання та шляхи за межами кореня пропускаються.

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

Відстеження перебігу траєкторії

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 відображає нещодавні події траєкторії середовища виконання як стислі рядки перебігу. Без --session-key він спочатку відстежує активні сеанси, а потім останній збережений сеанс. --tail <count> визначає, скільки наявних подій вивести перед режимом стеження; типове значення — 80, а 0 починає з поточного кінця. --follow продовжує стежити за вибраним сеансом на основі SQLite або явно заданим застарілим файлом траєкторії.

Подання перебігу навмисно консервативне: текст запиту, аргументи інструментів і тіла результатів інструментів не виводяться. Виклики інструментів показують назву інструмента з {...redacted...}; результати інструментів показують стан, як-от ok, error або done; рядки завершення моделі показують провайдера/модель і кінцевий стан.

Експорт пакета траєкторії

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

Це шлях команди, який використовує slash-команда /export-trajectory після того, як власник схвалить запит на виконання. Вихідний каталог завжди визначається всередині .openclaw/trajectory-exports/ у вибраному робочому просторі.

Обслуговування очищення

Запустіть обслуговування зараз, не чекаючи наступного циклу запису:

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 використовує параметри session.maintenance з конфігурації (Довідник конфігурації):

• Примітка щодо області дії: openclaw sessions cleanup обслуговує сховища сеансів, транскрипти, рядки траєкторій і застарілі супровідні файли траєкторій. Він не очищує історію запусків cron, яка автоматично зберігає 2000 найновіших рядків для кожного завдання (Конфігурація Cron).
• Очищення також видаляє непов’язані застарілі/архівні артефакти транскриптів, контрольні точки Compaction і супровідні файли траєкторій, старші за session.maintenance.pruneAfter; артефакти, на які все ще посилаються рядки сеансів SQLite, зберігаються.
• Очищення окремо звітує про очищення короткочасних пробних запусків моделі Gateway як modelRunPruned. Воно відповідає лише суворо визначеним явним ключам форми agent:*:explicit:model-run-<uuid>. Період зберігання фіксований — 24h, а очищення залежить від навантаження: застарілі рядки проб видаляються лише тоді, коли досягнуто порогу обслуговування або обмеження кількості записів сеансів. Під час його виконання очищення запусків моделі відбувається до глобального очищення застарілих записів і застосування обмежень.

Прапорці:

Коли Gateway доступний, очищення без пробного режиму для налаштованих сховищ агентів надсилається через Gateway, щоб воно використовувало той самий засіб запису сховища сеансів, що й трафік середовища виконання. Використовуйте --store <path> для явного автономного відновлення селектора застарілого сховища.

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

Ущільнення сеансу

Вивільніть бюджет контексту для заблокованого або надмірно великого сеансу. openclaw sessions compact <key> — це повноцінна обгортка для RPC Gateway sessions.compact, яка потребує запущеного Gateway.

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

• Без --max-lines Gateway підсумовує транскрипт за допомогою LLM. CLI типово не встановлює клієнтського кінцевого терміну; Gateway керує налаштованим життєвим циклом Compaction.
• З --max-lines <n> транскрипт скорочується до останніх n рядків, а попередній транскрипт архівується як супровідний файл .bak.
• --agent <id>: агент, якому належить сеанс; обов’язковий для ключів global.
• --url / --token / --password: перевизначення підключення Gateway.
• --timeout <ms>: необов’язковий клієнтський час очікування RPC у мілісекундах.
• --json: вивести необроблене корисне навантаження RPC.

Команда завершується з ненульовим кодом, коли Gateway повідомляє про невдалу Compaction або є недоступним, тому Cron і скрипти ніколи не сприймають безрезультатну операцію без повідомлень як успішну.

RPC sessions.compact

openclaw gateway call sessions.compact --params '<json>' приймає:

Приклад відповіді з узагальненням за допомогою LLM:

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

Приклад відповіді зі скороченням (--max-lines 200):

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

Пов’язані матеріали

• Конфігурація сеансу
• Керування сеансами
• Compaction
• Довідник CLI