Урок 6. Темы в боте и расширенный контекст

Что это и зачем

Один и тот же 1-на-1 чат с ботом разбивается на несколько параллельных лент со своими названиями и иконками. Сверху чата появляется навигация по разделам, у каждой темы — своя история и свой контекст.

Зачем это нужно:

• Контекст одного направления не сваливается в другое. Утром обсуждал миграцию, вечером пишешь про поездку — бот не тащит серверные детали в разговор про авиабилеты.
• Каждая тема доступна одним тапом из шапки чата — не нужно скроллить ленту назад.
• В каждой теме у бота своя сессия: своя история, свой контекст, свои настройки.
• Можно завести «постоянные» темы под повторяющиеся направления (Сервер, Код, Поездки, Напоминания) и не плодить отдельных ботов.

Включаем Threaded Mode в BotFather

Темы в личном чате с ботом нужно сначала разрешить на стороне бота. Это делается в BotFather:

1. Открой @BotFather → выбери своего бота → раздел Bot Settings.
2. Найди пункт про Threads / Threaded Mode / разрешение на создание тем в DM. Точное название иногда меняется, ориентируйся на формулировки про threads и темы в личных чатах.
3. Включи Threaded Mode.

Под ним есть второй тумблер — Disallow users to create new threads. С ним стоит разобраться отдельно, потому что он сильно меняет поведение чата.

Когда Disallow users to create new threads выключен, каждое новое сообщение, которое ты отправляешь мимо уже существующей темы, автоматически создаёт новую тему. Это удобно на этапе ознакомления — наглядно видно, как работают темы, и каждая мысль сразу получает свою «папку». Но в повседневной работе это быстро мешает: чат заваливается одноразовыми темами «привет», «а ещё», «короче», в которых лежит по одному сообщению. Поэтому в нормальном режиме этот тумблер включают — сообщения без темы идут в общую ленту, а темы заводятся осмысленно: либо тобой вручную через интерфейс Telegram, либо ботом по твоему запросу.

После включения Threaded Mode у тебя в личном чате с ботом появляется навигация по темам, а у бота — право их создавать и переименовывать.

Как OpenClaw работает с темами в DM

Внутри Telegram каждая тема в DM — это просто числовой thread ID, который автоматически прикрепляется к сообщениям в этой теме. OpenClaw на основе этого ID делает три вещи:

• Отдельная сессия на каждую тему. Сообщения из разных тем идут в разные сессии — у каждой темы своя история, свой контекст, своя память сессии.
• Сохраняет thread ID в исходящих ответах, чтобы ответ бота приходил именно в ту тему, откуда был задан вопрос.
• Прокидывает thread ID в шаблоны и логику ответа, если ты сам захочешь ветвить поведение по теме.

С точки зрения авторизации это всё ещё DM — tools.elevated.allowFrom.telegram со списком твоих ID работает в любой теме. Никаких дополнительных настроек в openclaw.json после включения тем в BotFather прописывать не нужно: OpenClaw подхватит темы автоматически.

Бот сам создаёт и поддерживает темы

Главное удобство — темы можно не придумывать вручную. У бота есть действие topic-create (под капотом — Telegram-метод createForumTopic), и оно включено по умолчанию. И самое приятное: списком направлений тоже не обязательно загружать его руками — бот уже знает, о чём вы регулярно говорите, и сам предложит разумную структуру. Достаточно написать:

Посмотри на свою память и на наши последние разговоры. Выдели направления, которые повторяются чаще всего, и заведи под них темы прямо здесь в Telegram. Названия и иконки придумай сам. Соответствие thread ID → название сохрани в TOPICS.md, чтобы дальше понимал, куда что относить.

Бот пройдётся по MEMORY.md, дневным заметкам и текущей сессии, выделит повторяющиеся направления (у каждого пользователя они получатся свои), создаст под них темы, выставит иконки и запишет соответствие thread ID → название в TOPICS.md. Дальше можно подтягивать новые темы по ходу:

Заведи отдельную тему «Wildberries API» и положи туда заметку про авторизацию.
Перенеси разговор про деплой в тему «Сервер и инфраструктура».
Каждое утро публикуй свод задач в тему «Быстрые задачи».

Зачем нужен TOPICS.md. Telegram отдаёт боту thread ID числом (3, 7, 42), а не названием. Без таблички соответствия в памяти бот не знает, что «3» — это «Код и разработка», особенно после нового запуска или сброса сессии. Файл вида:

# Темы в DM

| ID | Название |
|----|----------|
| 2  | 📺 Сервер и инфраструктура |
| 3  | ⚡ Быстрые задачи |
| 4  | 🔧 Код и разработка |
| 5  | 🧠 Память и настройки |
| 6  | 🧪 Исследования |
| 7  | 📌 Проекты |
| 8  | ✈️ Поездки и планирование |
| 9  | ⏰ Напоминания и ожидания |

— решает проблему раз и навсегда. Бот сам его обновит, когда заведёт новую тему.

Разные настройки для разных тем

Поскольку каждая тема в DM — это отдельная сессия, у неё может быть свой systemPrompt, свой набор навыков, свои правила. Конфигурируется так же, как темы форума, через channels.telegram.groups.<chatId>.topics.<threadId> — chatId здесь будет твоим Telegram user ID, потому что DM с точки зрения routing-а — это личный «канал» между ботом и тобой.

Пример: в теме «Поездки» включаем только travel-search, в теме «Код и разработка» — дев-инструменты:

{
  channels: {
    telegram: {
      groups: {
        "123456789": {           // твой Telegram user ID
          topics: {
            "4": {                // Код и разработка
              skills: ["web-search-plus", "github"],
              systemPrompt: "Ты дев-ассистент. Отвечай по делу, проверяй код на безопасность."
            },
            "8": {                // Поездки
              skills: ["travel-search", "web-search-plus"]
            }
          }
        }
      }
    }
  }
}

После правки:

openclaw gateway restart

Эта часть конфига — продвинутая и может в будущем измениться: сам факт DM-thread routing’а в OpenClaw встроен надёжно, а вот форма «развешивания» systemPrompt/skills на конкретные темы DM — менее обкатанная. Если в openclaw doctor или логах увидишь предупреждение про неподдерживаемое поле — скинь скрин в телеграм-канал курса, разберёмся вместе.

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

Режимы очереди

OpenClaw умеет несколько стратегий обработки сообщений во время активного запуска (документация):

Steering важно понимать правильно: твоё сообщение прилетает между шагами модели. Бот сначала доделает текущий tool call (например, докачает файл), потом увидит steer, и только потом решит, что делать дальше. Уже ушедший shell-command «выключить» нельзя, но логику до следующего шага — можно. Чтобы именно оборвать run — /queue interrupt.

Debounce, cap, drop

Общие дефолты очереди: mode: "steer", debounceMs: 500 (0,5 с), cap: 20, drop: "summarize".

debounceMs — окно тишины перед сливом followup/collect-пачек (и перед batched Codex turn/steer). В режиме collect логика такая:

• Сообщение во время run или сразу после — в очередь.
• Следующие сообщения внутри debounce-окна склеиваются с ним.
• После тишины (и конца активного run, если он ещё шёл) пачка уходит одним followup.
• Новое сообщение до истечения окна сбрасывает таймер.

Если пишешь медленно или часто дробишь мысль — увеличь окно: /queue collect debounce:2s. Нужны максимально быстрые одиночные followup — debounce:0.

Рядом:

• cap — максимум сообщений в очереди на сессию (дефолт 20); дальше срабатывает drop.
• drop: summarize (дефолт — выбросить старые, но подложить краткую сводку), old (выбросить старые без сводки), new (отклонить новые).

Команда /queue

Режим переключается на лету, без правки конфига:

/queue steer            # дефолт: вмешиваться в текущий run
/queue collect          # склеивать сообщения во время run в один followup
/queue followup         # каждое сообщение — отдельный followup
/queue interrupt        # оборвать run и стартовать с последнего сообщения
/queue default          # сбросить override сессии (/queue reset — то же)

Можно подкрутить параметры:

/queue collect debounce:2s cap:25 drop:summarize

• debounce — окно тишины (принимает ms/s/m/…).
• cap — лимит сообщений в очереди.
• drop — политика при переполнении: summarize / old / new.

Постоянно прописать в ~/.openclaw/openclaw.json:

{
  messages: {
    queue: {
      mode: "steer",
      debounceMs: 500,
      cap: 20,
      drop: "summarize",
      byChannel: {
        telegram: "steer",
        discord: "collect"
      }
    }
  }
}

Что выбрать на практике

• steer (дефолт) — удобен для длинных задач в Telegram: подкручиваешь ход на лету. Минус: короткая реплика «ок» / «стоп» может неожиданно свернуть run.
• collect — если реплики во время run хочешь копить и отдать одним followup, без вмешательства в текущий ход. Предсказуемее для «один вопрос → один ответ».
• followup — каждое сообщение после run’а — отдельный ход, без склейки.
• interrupt — когда нужно именно оборвать текущую работу и начать с последнего сообщения.

Удобный паттерн: оставить steer (он и так дефолт) и держать /btw для микро-вопросов мимо истории. Бот занят — ты подкручиваешь по ходу; побочный факт не оседает в сессии.