openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

Здоровий стан системи (baseline) повинен виглядати так:

• Runtime: running
• Connectivity probe: ok
• Capability: read-only, write-capable, або admin-capable
• Channel probe показує transport connected, а для підтримуваних каналів — works або audit ok .

Типові проблеми Telegram-бота та їх вирішення

1. Бот онлайн, але ігнорує повідомлення в групах

Класична проблема, коли бот відповідає в особистих повідомленнях, але мовчить у групових чатах. Згідно з документацією, причина криється в налаштуваннях приватності та згадуваннях .

Що перевірити:

• Параметр requireMention у конфігурації. Можливо, бот очікує, що його згадають на ім'я.
• Режим приватності бота (Privacy Mode). Якщо його увімкнено, бот бачить лише команди та повідомлення, що починаються з /. Щоб бот бачив усі повідомлення, вимкніть Privacy Mode через /setprivacy у BotFather.
• Як найкраще застосувати зміни: після зміни налаштувань в BotFather видаліть бота з групи та додайте його знову. Часто достатньо надати боту права адміністратора в групі .

2. Помилка 401 Unauthorized при запуску

Повідомлення getMe returned 401 означає, що токен бота, отриманий від BotFather, є недійсним або протермінованим.

Рішення:

• Перевірте правильність змінної TELEGRAM_BOT_TOKEN або параметрів botToken / tokenFile у конфігурації OpenClaw.
• За потреби згенеруйте новий токен у BotFather та оновіть його в системі .

3. Помилка 409 Conflict (getUpdates 409)

Ця помилка свідчить про конфлікт опитувань. Система довгого опитування (Long polling) OpenClaw спроєктована так, щоб лише один активний обробник використовував токен бота в межах процесу шлюзу .

Ймовірна причина:

• Інший екземпляр OpenClaw gateway, сторонній скрипт або зовнішній сервіс використовує той самий токен бота.

Рішення:

• Зупиніть усі зайві процеси або шлюзи, які можуть звертатися до API Telegram з цим токеном. Переконайтеся, що запущено лише один активний шлюз для цього бота .

4. Зависання опитування або повільне перепідключення

Якщо бот періодично завмирає або довго перепідключається, слідкуйте за логами в реальному часі.

Діагностика:

• Виконайте openclaw logs --follow. Якщо повідомлення вказують на мережеві помилки, проблема часто пов'язана з DNS, IPv6 або налаштуваннями проксі-маршрутизації до api.telegram.org .
• Системний watchdog за замовчуванням перезапускає опитування, якщо немає відповіді від getUpdates протягом 120 секунд. Якщо ви впевнені у стабільності мережі, можна збільшити параметр channels.telegram.pollingStallThresholdMs, але спочатку перевірте мережевий шлях .

Що робити, якщо бот зламався після оновлення

Після встановлення оновлень рекомендовано виконати повний цикл перевірки та очищення:

1. openclaw status --all
2. openclaw doctor --fix
3. openclaw gateway restart
4. openclaw status --all (повторна перевірка)

Якщо ви бачите помилку plugin load failed: dependency tree corrupted, це означає, що канал налаштовано, але під час завантаження плагіна сталася внутрішня помилка залежностей. Команда openclaw doctor --fix очищає старі «тіньові» копії та кеш автентифікації, після чого потрібно перезапустити шлюз .

Правильна конфігурація Telegram в OpenClaw

Важливо розуміти стандартний робочий процес. OpenClaw для Telegram не використовує команду openclaw channels login telegram. Натомість токен береться з конфігурації або змінних оточення, після чого канал активується прапорцем channels.telegram.enabled: true і запускається шлюз .

Для особистих повідомлень (DM) за замовчуванням використовується механізм сполучення (pairing). Після запуску шлюзу надішліть боту повідомлення. Система згенерує код сполучення. Підтвердити його можна командою:

openclaw pairing approve telegram КОД_СПОЛУЧЕННЯ

Або перевірити список очікуваних сполучень через openclaw pairing list telegram .

Висновок

Якщо бот «не працює» — це не вирок, а привід для системної діагностики. Почніть із п'яти базових команд, наведених вище. Для Telegram уважно перевірте чотири найпоширеніші джерела проблем:

• Налаштування приватності/згадувань
• Недійсний токен (помилка 401)
• Конфлікт опитувань (помилка 409)
• Мережеві проблеми (DNS/IPv6/проксі)

Зібравши логи та результати діагностичних команд, ви зможете точно визначити причину та швидко повернути бота до життя.

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

Здоровий стан системи (baseline) повинен виглядати так:

• Runtime: running
• Connectivity probe: ok
• Capability: read-only, write-capable, або admin-capable
• Channel probe показує transport connected, а для підтримуваних каналів — works або audit ok .

Типові проблеми Telegram-бота та їх вирішення

1. Бот онлайн, але ігнорує повідомлення в групах

Класична проблема, коли бот відповідає в особистих повідомленнях, але мовчить у групових чатах. Згідно з документацією, причина криється в налаштуваннях приватності та згадуваннях .

Що перевірити:

• Параметр requireMention у конфігурації. Можливо, бот очікує, що його згадають на ім'я.
• Режим приватності бота (Privacy Mode). Якщо його увімкнено, бот бачить лише команди та повідомлення, що починаються з /. Щоб бот бачив усі повідомлення, вимкніть Privacy Mode через /setprivacy у BotFather.
• Як найкраще застосувати зміни: після зміни налаштувань в BotFather видаліть бота з групи та додайте його знову. Часто достатньо надати боту права адміністратора в групі .

2. Помилка 401 Unauthorized при запуску

Повідомлення getMe returned 401 означає, що токен бота, отриманий від BotFather, є недійсним або протермінованим.

Рішення:

• Перевірте правильність змінної TELEGRAM_BOT_TOKEN або параметрів botToken / tokenFile у конфігурації OpenClaw.
• За потреби згенеруйте новий токен у BotFather та оновіть його в системі .

3. Помилка 409 Conflict (getUpdates 409)

Ця помилка свідчить про конфлікт опитувань. Система довгого опитування (Long polling) OpenClaw спроєктована так, щоб лише один активний обробник використовував токен бота в межах процесу шлюзу .

Ймовірна причина:

• Інший екземпляр OpenClaw gateway, сторонній скрипт або зовнішній сервіс використовує той самий токен бота.

Рішення:

• Зупиніть усі зайві процеси або шлюзи, які можуть звертатися до API Telegram з цим токеном. Переконайтеся, що запущено лише один активний шлюз для цього бота .

4. Зависання опитування або повільне перепідключення

Якщо бот періодично завмирає або довго перепідключається, слідкуйте за логами в реальному часі.

Діагностика:

• Виконайте openclaw logs --follow. Якщо повідомлення вказують на мережеві помилки, проблема часто пов'язана з DNS, IPv6 або налаштуваннями проксі-маршрутизації до api.telegram.org .
• Системний watchdog за замовчуванням перезапускає опитування, якщо немає відповіді від getUpdates протягом 120 секунд. Якщо ви впевнені у стабільності мережі, можна збільшити параметр channels.telegram.pollingStallThresholdMs, але спочатку перевірте мережевий шлях .

Що робити, якщо бот зламався після оновлення

Після встановлення оновлень рекомендовано виконати повний цикл перевірки та очищення:

1. openclaw status --all
2. openclaw doctor --fix
3. openclaw gateway restart
4. openclaw status --all (повторна перевірка)

Якщо ви бачите помилку plugin load failed: dependency tree corrupted, це означає, що канал налаштовано, але під час завантаження плагіна сталася внутрішня помилка залежностей. Команда openclaw doctor --fix очищає старі «тіньові» копії та кеш автентифікації, після чого потрібно перезапустити шлюз .

Правильна конфігурація Telegram в OpenClaw

Важливо розуміти стандартний робочий процес. OpenClaw для Telegram не використовує команду openclaw channels login telegram. Натомість токен береться з конфігурації або змінних оточення, після чого канал активується прапорцем channels.telegram.enabled: true і запускається шлюз .

Для особистих повідомлень (DM) за замовчуванням використовується механізм сполучення (pairing). Після запуску шлюзу надішліть боту повідомлення. Система згенерує код сполучення. Підтвердити його можна командою:

openclaw pairing approve telegram КОД_СПОЛУЧЕННЯ

Або перевірити список очікуваних сполучень через openclaw pairing list telegram .

Висновок

Якщо бот «не працює» — це не вирок, а привід для системної діагностики. Почніть із п'яти базових команд, наведених вище. Для Telegram уважно перевірте чотири найпоширеніші джерела проблем:

• Налаштування приватності/згадувань
• Недійсний токен (помилка 401)
• Конфлікт опитувань (помилка 409)
• Мережеві проблеми (DNS/IPv6/проксі)

Зібравши логи та результати діагностичних команд, ви зможете точно визначити причину та швидко повернути бота до життя.