OpenClaw botchat не працює? Покрокова діагностика та виправлення помилок

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

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

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

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

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

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

Повідомлення

getMe returned 401

Рішення:

• Перевірте правильність змінної 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 list telegram

Висновок

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

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

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