В супергруппах Telegram с включёнными темами форума поле MessageThreadId определяет путь транскриптов OpenClaw; Heartbeat и ответы инструментов легко падают в корневой чат. Материал (контекст v2026.4.14 / 4.x) закрывает боли, матрицу решений, таблицу «симптом — лог — фикс», заметки про webhook и long polling, восемь шагов, ориентиры и VNC-приёмку.
1) Типовые сбои
- Пропал идентификатор темы: пересланные сообщения или редкие клиенты не передают
message_thread_id; один человек получает два пути транскрипта. Смешение General и именованных тем ломает ожидания. - Дрейф Heartbeat: без явной цели или
lastавтосообщения уходят в корень. Длинные ссылки и текст инструмента ведут себя как трансляция—фиксируйте частоту, @all и политику корня. - Расхождение outbound инструментов: карточки одобрения (поиск, запись файлов) могут идти по другой очереди; финальный ответ оказывается не в той ветке. Хелперы должны всегда тащить последний входящий thread id.
Симптом → лог → первый фикс
Таблица для тикета: UI Telegram, консоль Gateway и локальные логи на одном VNC-экране.
| Что видите | Какие логи собрать | Первый шаг (без смены модели) | Эскалация |
|---|---|---|---|
| Потеря контекста | Два входящих с разными путями; у одного нет thread | Тестовый аккаунт только в дочерней теме, без цепочек пересылок | Отдельный бот на тему или отключить форум |
| Heartbeat мешает чужой ветке | Исходящий JSON без thread или со старым id | Привязать к явной теме / last, перезапустить Gateway | Интервал + джиттер, короткий статус |
| Ответ инструмента «не в той комнате» | Вход с thread, выход без | Ассерт: без thread не постим автоматически | Следовать по reply_to_message_id |
Как в статье про мультиканал: сначала один канал до дым-теста.
2) Матрица
| Стиль работы | Топология | Стоимость | Риск |
|---|---|---|---|
| Параллельные проекты | Форум + один бот + жёсткий роутинг | Высокая | Расщепление транскриптов |
| Маленькая команда | Обычная супергруппа | Низкая | Форум лишний |
| Жёсткая изоляция | Несколько ботов / групп | Высокая | Больше секретов |
| Только трансляции | Канал + отдельный админ-чат | Средняя | Плохо для многоходовых агентов |
| Уже мультиканал | Изолированное окно Telegram-форума | Средняя | Шум атрибуции |
7) Симптомы / логи / фикс и транспорт
Порядок жёсткий: событие Telegram доходит до Gateway → поля темы → затем модель/инструменты. Webhook даёт скорость, но страдает от reverse proxy, сертификатов и дублей; long polling на удалённом Mac с агрессивным сном выглядит как «пропали темы», хотя завис воркер.
| Транспорт | Плюс для форума | Частая поломка | Как помогает VNC |
|---|---|---|---|
| Webhook | Корреляция с HTTP-логами | Публичный вход, таймауты | Открыть health URL в браузере удалённого Mac, снять заголовки/TLS |
| Long polling | Простая лаборатория | Зависший процесс | top и метки времени Telegram параллельно |
{
"update_id": 100000000,
"message": {
"message_id": 2048,
"chat": { "id": -1001234567890, "title": "Demo", "is_forum": true },
"message_thread_id": 99,
"from": { "id": 12345, "is_bot": false },
"text": "Продолжить цепочку инструментов в этой теме"
}
}
При null сначала чистый текст без пересылок.
3) Восемь шагов
Проверить форум в клиенте
Скриншоты, chat_id.
Убедиться, что композер не сидит в General; сверить last тестера и Gateway.
Минимальные права бота (VNC)
Политика сервисных сообщений.
Одна тема, плотные раунды инструментов
Параллельный спам двух коллег до второй темы.
Маскированный JSON
Пары вход/выход в ту же секунду.
Heartbeat с явной целью
Перезапуск Gateway после смены политики.
Плагины и исходящий thread
Карточки и простой текст.
openclaw doctor
Версия в тикете.
Runbook отката
Форум выкл, webhook снять, бэкап.
Указатель на транскрипты до форума для аудита.
4) Ориентиры
5) VNC-приёмка
Десять минут перед релизом; повторять после минорных обновлений.
- Ожидаемый
message_thread_idво входе - Heartbeat не в корне
- Две темы параллельно без коллизий файлов
- Скриншоты отката
- Карточка одобрения и финал в одной ветке
- Без агрессивного сна NIC
6) FAQ
В: строго 4.14? Эталон — установленная сборка.
Итог: VNCMac с VNC держит Telegram Desktop и консоль Gateway на одной поверхности доказательств.