---
read_when:
    - Ви хочете зрозуміти маршрутизацію та ізоляцію сесій
    - Ви хочете налаштувати область дії DM для конфігурацій із кількома користувачами
summary: Як OpenClaw керує сесіями розмови
title: Керування сесіями
x-i18n:
    generated_at: "2026-04-23T22:59:17Z"
    model: gpt-5.4
    provider: openai
    source_hash: cafff1fd480bdd306f87c818e7cb66bda8440d643fbe9ce5e14b773630b35d37
    source_path: concepts/session.md
    workflow: 15
---

OpenClaw організовує розмови в **сесії**. Кожне повідомлення маршрутизується до
сесії залежно від того, звідки воно надійшло -- DM, групові чати, завдання Cron тощо.

## Як маршрутизуються повідомлення

| Джерело         | Поведінка                     |
| --------------- | ----------------------------- |
| Прямі повідомлення | Спільна сесія за замовчуванням |
| Групові чати    | Ізольовано для кожної групи   |
| Кімнати/канали  | Ізольовано для кожної кімнати |
| Завдання Cron   | Нова сесія для кожного запуску |
| Webhook         | Ізольовано для кожного hook   |

## Ізоляція DM

За замовчуванням усі DM використовують одну спільну сесію для безперервності. Це добре підходить
для конфігурацій з одним користувачем.

<Warning>
Якщо кілька людей можуть надсилати повідомлення вашому агенту, увімкніть ізоляцію DM. Без неї всі
користувачі спільно використовують той самий контекст розмови -- приватні повідомлення Alice будуть видимі Bob.
</Warning>

**Виправлення:**

```json5
{
  session: {
    dmScope: "per-channel-peer", // ізолювати за каналом + відправником
  },
}
```

Інші варіанти:

- `main` (типово) -- усі DM використовують одну спільну сесію.
- `per-peer` -- ізоляція за відправником (між каналами).
- `per-channel-peer` -- ізоляція за каналом + відправником (рекомендовано).
- `per-account-channel-peer` -- ізоляція за обліковим записом + каналом + відправником.

<Tip>
Якщо та сама людина зв’язується з вами з кількох каналів, використовуйте
`session.identityLinks`, щоб пов’язати її ідентичності й дати їм спільну сесію.
</Tip>

Перевірте свою конфігурацію за допомогою `openclaw security audit`.

## Життєвий цикл сесії

Сесії повторно використовуються, доки не завершиться строк їхньої дії:

- **Щоденне скидання** (типово) -- нова сесія о 4:00 ранку за місцевим часом на хості
  Gateway.
- **Скидання за неактивністю** (необов’язково) -- нова сесія після певного періоду бездіяльності. Установіть
  `session.reset.idleMinutes`.
- **Ручне скидання** -- введіть `/new` або `/reset` у чаті. `/new <model>` також
  перемикає модель.

Коли налаштовані і щоденне скидання, і скидання за неактивністю, спрацьовує те, що настає раніше.

Сесії з активною CLI-сесією, якою володіє provider, не розриваються неявним
щоденним скиданням за замовчуванням. Використовуйте `/reset` або явно налаштуйте `session.reset`, якщо такі
сесії мають завершуватися за таймером.

## Де зберігається стан

Увесь стан сесії належить **gateway**. Клієнти UI запитують у gateway дані
сесії.

- **Сховище:** `~/.openclaw/agents/<agentId>/sessions/sessions.json`
- **Стенограми:** `~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl`

## Обслуговування сесій

OpenClaw автоматично обмежує обсяг сховища сесій із часом. За замовчуванням він працює
в режимі `warn` (повідомляє, що було б очищено). Установіть `session.maintenance.mode`
у `"enforce"` для автоматичного очищення:

```json5
{
  session: {
    maintenance: {
      mode: "enforce",
      pruneAfter: "30d",
      maxEntries: 500,
    },
  },
}
```

Попередній перегляд: `openclaw sessions cleanup --dry-run`.

## Перегляд сесій

- `openclaw status` -- шлях до сховища сесій і нещодавня активність.
- `openclaw sessions --json` -- усі сесії (фільтруйте через `--active <minutes>`).
- `/status` у чаті -- використання контексту, модель і перемикачі.
- `/context list` -- що входить до system prompt.

## Додаткове читання

- [Session Pruning](/uk/concepts/session-pruning) -- обрізання результатів інструментів
- [Compaction](/uk/concepts/compaction) -- підсумовування довгих розмов
- [Session Tools](/uk/concepts/session-tool) -- інструменти агента для міжсесійної роботи
- [Поглиблений огляд керування сесіями](/uk/reference/session-management-compaction) --
  схема сховища, стенограми, політика надсилання, метадані походження та розширена конфігурація
- [Multi-Agent](/uk/concepts/multi-agent) — маршрутизація та ізоляція сесій між агентами
- [Фонові завдання](/uk/automation/tasks) — як відокремлена робота створює записи завдань із посиланнями на сесії
- [Маршрутизація каналів](/uk/channels/channel-routing) — як вхідні повідомлення маршрутизуються до сесій

## Пов’язано

- [Session pruning](/uk/concepts/session-pruning)
- [Session tools](/uk/concepts/session-tool)
- [Черга команд](/uk/concepts/queue)
