> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Сеансы # `openclaw sessions` Выводит список сохраненных сеансов бесед. Списки сеансов не являются проверками работоспособности каналов/провайдеров. Они показывают сохраненные строки бесед из хранилищ сеансов. Тихий Discord, Slack, Telegram или другой канал может успешно переподключиться без создания новой строки сеанса до обработки сообщения. Используйте `openclaw channels status --probe`, `openclaw status --deep` или `openclaw health --verbose`, когда нужна текущая связность канала. Ответы `openclaw sessions` и Gateway `sessions.list` по умолчанию ограничены, чтобы большие долгоживущие хранилища не могли монополизировать процесс CLI или цикл событий Gateway. CLI по умолчанию возвращает 100 новейших сеансов; передайте `--limit ` для меньшего/большего окна или `--limit all`, когда намеренно нужно все хранилище. JSON-ответы включают `totalCount`, `limitApplied` и `hasMore`, когда вызывающим сторонам нужно показать, что существуют дополнительные строки. RPC-клиенты могут передать `configuredAgentsOnly: true`, чтобы сохранить широкий объединенный источник обнаружения, но возвращать только строки для агентов, которые сейчас есть в конфигурации. Control UI использует этот режим по умолчанию, чтобы удаленные или существующие только на диске хранилища агентов не появлялись снова в представлении сеансов. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw sessions openclaw sessions --agent work openclaw sessions --all-agents openclaw sessions --active 120 openclaw sessions --limit 25 openclaw sessions --verbose openclaw sessions --json ``` Выбор области: * по умолчанию: настроенное хранилище агента по умолчанию * `--verbose`: подробное журналирование * `--agent `: одно настроенное хранилище агента * `--all-agents`: объединить все настроенные хранилища агентов * `--store `: явный путь к хранилищу (нельзя сочетать с `--agent` или `--all-agents`) * `--limit `: максимальное число строк для вывода (по умолчанию `100`; `all` восстанавливает полный вывод) Отслеживать человекочитаемый прогресс траектории для сохраненных сеансов: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw sessions tail openclaw sessions tail --follow openclaw sessions tail --session-key "agent:main:telegram:direct:123" --tail 25 openclaw sessions --agent work tail --follow openclaw sessions --all-agents tail --follow ``` `openclaw sessions tail` отображает недавние события JSONL траектории в виде компактных строк прогресса. Без `--session-key` он сначала отслеживает выполняющиеся сеансы, затем последний сохраненный сеанс. `--tail ` управляет тем, сколько существующих событий печатается перед режимом отслеживания; значение по умолчанию — `80`, а `0` начинает с текущего конца. `--follow` продолжает наблюдать за выбранными файлами траекторий, включая перемещенные файлы, на которые ссылается `.trajectory-path.json`. Представление прогресса намеренно консервативно: текст промпта, аргументы инструментов и тела результатов инструментов не печатаются. Вызовы инструментов показывают имя инструмента с `{...redacted...}`; результаты инструментов показывают статус, например `ok`, `error` или `done`; строки завершения модели показывают провайдера/модель и терминальный статус. Экспортировать пакет траектории для сохраненного сеанса: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 --all-agents` читает настроенные хранилища агентов. Обнаружение сеансов Gateway и ACP шире: они также включают хранилища только на диске, найденные в корне `agents/` по умолчанию или в шаблонном корне `session.store`. Эти обнаруженные хранилища должны разрешаться в обычные файлы `sessions.json` внутри корня агента; символические ссылки и пути за пределами корня пропускаются. Примеры JSON: `openclaw sessions --all-agents --json`: ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "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": "gpt-5" }, { "agentId": "work", "key": "agent:work:main", "model": "claude-opus-4-6" } ] } ``` ## Обслуживание очистки Запустить обслуживание сейчас (вместо ожидания следующего цикла записи): ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw sessions cleanup --dry-run openclaw sessions cleanup --agent work --dry-run openclaw sessions cleanup --all-agents --dry-run openclaw sessions cleanup --enforce openclaw sessions cleanup --enforce --active-key "agent:main:telegram:direct:123" openclaw sessions cleanup --dry-run --fix-dm-scope openclaw sessions cleanup --json ``` `openclaw sessions cleanup` использует настройки `session.maintenance` из конфигурации: * Примечание об области: `openclaw sessions cleanup` обслуживает хранилища сеансов, транскрипты и sidecar-файлы траекторий. Он не сокращает историю запусков Cron, которой управляет `cron.runLog.keepLines` в [конфигурации Cron](https://docs2.openclaw.ai/ru/automation/cron-jobs.md#configuration) и которая объясняется в [обслуживании Cron](https://docs2.openclaw.ai/ru/automation/cron-jobs.md#maintenance). * Очистка также удаляет несвязанные основные транскрипты, контрольные точки Compaction и sidecar-файлы траекторий старше `session.maintenance.pruneAfter`; файлы, на которые все еще ссылается `sessions.json`, сохраняются. * Очистка отдельно сообщает об удалении короткоживущих проверок запусков моделей Gateway как `modelRunPruned`. Это соответствует только строгим явным ключам формы `agent:*:explicit:model-run-`. Фиксированное удержание составляет `24h`, но оно ограничено давлением: устаревшие строки проверок удаляются только тогда, когда достигнуто обслуживание записей сеансов/давление лимита. Когда это выполняется, очистка запусков моделей происходит перед глобальной очисткой устаревших записей и ограничением. * `--dry-run`: предварительно показать, сколько записей было бы удалено/ограничено без записи. * В текстовом режиме dry-run печатает таблицу действий по сеансам (`Action`, `Key`, `Age`, `Model`, `Flags`) и сводку, сгруппированную по метке сеанса, чтобы было видно, что будет сохранено, а что удалено. * `--enforce`: применить обслуживание, даже когда `session.maintenance.mode` равно `warn`. * `--fix-missing`: удалить записи, чьи файлы транскриптов отсутствуют или содержат только заголовок/пусты, даже если по возрасту/числу они еще обычно не подлежали бы удалению. * `--fix-dm-scope`: когда `session.dmScope` равно `main`, вывести из обращения устаревшие строки прямых DM с ключами пиров, оставшиеся после более ранней маршрутизации `per-peer`, `per-channel-peer` или `per-account-channel-peer`. Сначала используйте `--dry-run`; применение очистки удаляет эти строки из `sessions.json` и сохраняет их транскрипты как удаленные архивы. * `--active-key `: защитить конкретный активный ключ от вытеснения по дисковому бюджету. Долговечные внешние указатели бесед, такие как групповые сеансы и сеансы чатов в рамках тредов, также сохраняются обслуживанием по возрасту/числу/дисковому бюджету. * `--agent `: выполнить очистку для одного настроенного хранилища агента. * `--all-agents`: выполнить очистку для всех настроенных хранилищ агентов. * `--store `: выполнить для конкретного файла `sessions.json`. * `--json`: напечатать JSON-сводку. С `--all-agents` вывод включает одну сводку на хранилище. Когда Gateway доступен, очистка без dry-run для настроенных хранилищ агентов отправляется через Gateway, чтобы использовать тот же писатель хранилища сеансов, что и runtime-трафик. Используйте `--store ` для явного офлайн-восстановления файла хранилища. `openclaw sessions cleanup --all-agents --dry-run --json`: ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "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 ` — первоклассная оболочка вокруг Gateway RPC `sessions.compact`, требующая запущенного Gateway. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw sessions compact "agent:main:main" openclaw sessions compact "agent:main:main" --max-lines 200 openclaw sessions compact "agent:work:main" --agent work --json ``` * Без `--max-lines` Gateway выполняет LLM-суммаризацию транскрипта. CLI по умолчанию не накладывает клиентский дедлайн; Gateway владеет настроенным жизненным циклом Compaction. * С `--max-lines ` он усекает до последних `n` строк транскрипта и архивирует предыдущий транскрипт как sidecar `.bak`. * `--agent `: агент, которому принадлежит сеанс; требуется для ключей `global`. * `--url` / `--token` / `--password`: переопределения подключения к Gateway. * `--timeout `: необязательный клиентский тайм-аут RPC в миллисекундах. * `--json`: напечатать сырой payload RPC. Команда завершается с ненулевым кодом, когда Gateway сообщает о неудачной Compaction или недоступен, поэтому Cron и скрипты никогда не принимают тихую операцию без эффекта за успех. > Примечание: `openclaw agent --message '/compact ...'` — **не** путь Compaction. Slash-команды из CLI отклоняются проверкой авторизованного отправителя; такой вызов завершается с ненулевым кодом и подсказкой сюда вместо тихой операции без эффекта. ### RPC `sessions.compact` `openclaw gateway call sessions.compact --params ''` принимает: | Поле | Тип | Обязательно | Описание | | - | - | - | - | | `key` | string | да | Ключ сеанса для сжатия (например `agent:main:main`). | | `agentId` | string | нет | Идентификатор агента, которому принадлежит сеанс (для ключей `global`). | | `maxLines` | integer ≥ 1 | нет | Усечь до последних N строк вместо LLM-суммаризации. | Пример ответа LLM-суммаризации: ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "ok": true, "key": "agent:main:main", "compacted": true, "result": { "tokensBefore": 243868, "tokensAfter": 34941 } } ``` Пример ответа усечения (`--max-lines 200`): ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "ok": true, "key": "agent:main:main", "compacted": true, "archived": "/home/user/.openclaw/agents/main/sessions/transcripts/.jsonl.bak", "kept": 200 } ``` ## Связанное * Конфигурация сеансов: [справочник по конфигурации](https://docs2.openclaw.ai/ru/gateway/config-agents.md#session) * [справочник CLI](https://docs2.openclaw.ai/ru/cli.md) * [управление сеансами](https://docs2.openclaw.ai/ru/concepts/session.md)