Усунення несправностей каналів

Використовуйте цю сторінку, коли канал підключається, але працює неправильно.

Послідовність команд

Спочатку виконайте ці команди по черзі:

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

Ознаки справного стану:

Runtime: running
Connectivity probe: ok
Capability: read-only, write-capable або admin-capable
Перевірка каналу показує, що транспорт підключено, а там, де це підтримується, — works або audit ok

Після оновлення

Скористайтеся цим, якщо після оновлення зникає Telegram, iMessage, конфігурації часів BlueBubbles або інший канал Plugin.

openclaw status --all
openclaw doctor --fix
openclaw gateway restart
openclaw status --all

Шукайте plugin load failed: dependency tree corrupted; run openclaw doctor --fix у виводі openclaw status --all. Це означає, що канал налаштовано, але під час налаштування або завантаження Plugin виявлено пошкоджене дерево залежностей, тому канал не було зареєстровано. Команда openclaw doctor --fix видаляє застарілі символічні посилання залежностей середовища виконання Plugin і застарілі тіньові дані автентифікації, після чого openclaw gateway restart перезавантажує чистий стан.

Ознаки збоїв WhatsApp

Симптом	Найшвидша перевірка	Виправлення
Підключено, але немає відповідей у приватних повідомленнях	`openclaw pairing list whatsapp`	Схваліть відправника або змініть політику приватних повідомлень чи список дозволених.
Групові повідомлення ігноруються	Перевірте `requireMention` і шаблони згадок у конфігурації	Згадайте бота або послабте політику згадок для цієї групи.
Вхід за QR-кодом завершується помилкою 408 через перевищення часу очікування	Перевірте змінні середовища Gateway `HTTPS_PROXY` / `HTTP_PROXY`	Укажіть доступний проксі; використовуйте `NO_PROXY` лише для обходу проксі.
Випадкові цикли відключення й повторного входу	`openclaw channels status --probe` і журнали	Нещодавні повторні підключення позначаються навіть за поточного підключення; стежте за журналами, перезапустіть Gateway, а якщо нестабільність триває — повторно прив’яжіть обліковий запис.
Цикл `status=408 Request Time-out`	Перевірка, журнали, doctor, потім стан Gateway	Спочатку виправте проблеми з підключенням або часовими параметрами хоста; якщо цикл триває, створіть резервну копію даних автентифікації та повторно прив’яжіть обліковий запис.
Відповіді надходять із затримкою в секунди або хвилини	`openclaw doctor --fix`	Doctor зупиняє перевірені застарілі локальні клієнти TUI, якщо вони погіршують роботу циклу подій Gateway.

Повний посібник з усунення несправностей: Усунення несправностей WhatsApp

Ознаки збоїв Telegram

Симптом	Найшвидша перевірка	Виправлення
`/start`, але немає придатного потоку відповідей	`openclaw pairing list telegram`	Схваліть сполучення або змініть політику приватних повідомлень.
Бот у мережі, але група залишається без відповіді	Перевірте вимогу згадки та режим приватності бота	Вимкніть режим приватності, щоб бот бачив повідомлення групи, або згадайте бота.
Помилки надсилання через мережеві збої	Перевірте журнали на наявність помилок викликів API Telegram	Виправте маршрутизацію DNS/IPv6/проксі до `api.telegram.org`.
Під час запуску повідомляється `getMe returned 401`	Перевірте налаштоване джерело токена	Повторно скопіюйте або згенеруйте токен BotFather і оновіть `botToken`, `tokenFile` або `TELEGRAM_BOT_TOKEN` стандартного облікового запису.
Опитування зависає або повільно перепідключається	Перегляньте діагностику опитування через `openclaw logs --follow`	Оновіть систему; якщо перезапуски є хибними спрацюваннями, налаштуйте `pollingStallThresholdMs`. Стійкі зависання й далі вказують на проблеми проксі/DNS/IPv6.
`setMyCommands` відхиляється під час запуску	Перевірте журнали на наявність `BOT_COMMANDS_TOO_MUCH`	Зменште кількість команд Telegram від Plugin, Skills або користувацьких команд чи вимкніть вбудовані меню.
Після оновлення список дозволених блокує вас	`openclaw security audit` і списки дозволених у конфігурації	Виконайте `openclaw doctor --fix` або замініть `@username` на числові ідентифікатори відправників.

Повний посібник з усунення несправностей: Усунення несправностей Telegram

Discord

Ознаки збоїв Discord

Симптом	Найшвидша перевірка	Виправлення
Бот у мережі, але не відповідає на сервері	`openclaw channels status --probe`	Дозвольте сервер або канал і перевірте дозвіл на доступ до вмісту повідомлень.
Групові повідомлення ігноруються	Перевірте журнали на наявність відхилень через обмеження згадок	Згадайте бота або встановіть для сервера чи каналу `requireMention: false`.
Є індикація набору тексту або використання токенів, але немає повідомлення Discord	Перевірте, чи це фонова подія кімнати або кімната з увімкненим `message_tool`, де модель не викликала `message(action=send)`	Перевірте докладний журнал Gateway на наявність метаданих приглушеного кінцевого корисного навантаження, перевірте `messages.groupChat.unmentionedInbound`, прочитайте Фонові події кімнати або залиште `messages.groupChat.visibleReplies: "automatic"` для звичайних групових запитів.
Відсутні відповіді у приватних повідомленнях	`openclaw pairing list discord`	Схваліть сполучення приватних повідомлень або змініть їхню політику.

Повний посібник з усунення несправностей: Усунення несправностей Discord

Slack

Ознаки збоїв Slack

Симптом	Найшвидша перевірка	Виправлення
Режим сокетів підключено, але відповідей немає	`openclaw channels status --probe`	Перевірте токен застосунку, токен бота й необхідні області доступу; у конфігураціях на основі SecretRef стежте за `botTokenStatus` / `appTokenStatus = configured_unavailable`.
Приватні повідомлення заблоковано	`openclaw pairing list slack`	Схваліть сполучення або послабте політику приватних повідомлень.
Повідомлення каналу ігнорується	Перевірте `groupPolicy` і список дозволених каналів	Дозвольте канал або змініть політику на `open`.

Повний посібник з усунення несправностей: Усунення несправностей Slack

iMessage

Ознаки збоїв iMessage

Симптом	Найшвидша перевірка	Виправлення
`imsg` відсутній або не працює не на macOS	`openclaw channels status --probe --channel imessage`	Запустіть OpenClaw на Mac із Messages або використовуйте обгортку SSH для `cliPath`.
Надсилання працює, але отримання на macOS — ні	Перевірте дозволи конфіденційності macOS для автоматизації Messages	Повторно надайте дозволи TCC і перезапустіть процес каналу.
Відправника приватного повідомлення заблоковано	`openclaw pairing list imessage`	Схваліть сполучення або оновіть список дозволених.

Повний посібник з усунення несправностей: Усунення несправностей iMessage

Signal

Ознаки збоїв Signal

Симптом	Найшвидша перевірка	Виправлення
Демон доступний, але бот не відповідає	`openclaw channels status --probe`	Перевірте URL демона `signal-cli`, обліковий запис і режим отримання.
Приватні повідомлення заблоковано	`openclaw pairing list signal`	Схваліть відправника або змініть політику приватних повідомлень.
Групові відповіді не спрацьовують	Перевірте список дозволених груп і шаблони згадок	Додайте відправника або групу чи послабте обмеження.

Повний посібник з усунення несправностей: Усунення несправностей Signal

QQ Bot

Ознаки збоїв QQ Bot

Симптом	Найшвидша перевірка	Виправлення
Бот відповідає «полетів на Марс»	Перевірте `appId` і `clientSecret` у конфігурації	Укажіть облікові дані або перезапустіть Gateway.
Немає вхідних повідомлень	`openclaw channels status --probe`	Перевірте облікові дані на QQ Open Platform.
Голос не перетворюється на текст	Перевірте конфігурацію постачальника STT	Налаштуйте `channels.qqbot.stt` або `tools.media.audio`.
Проактивні повідомлення не надходять	Перевірте вимоги платформи QQ до взаємодії	QQ може блокувати повідомлення, ініційовані ботом, якщо нещодавньої взаємодії не було.

Повний посібник з усунення несправностей: Усунення несправностей QQ Bot

Matrix

Ознаки збоїв Matrix

Симптом	Найшвидша перевірка	Виправлення
Вхід виконано, але повідомлення в кімнаті ігноруються	`openclaw channels status --probe`	Перевірте `groupPolicy`, список дозволених кімнат і вимогу згадування.
Приватні повідомлення не обробляються	`openclaw pairing list matrix`	Схваліть відправника або скоригуйте політику приватних повідомлень.
Зашифровані кімнати не працюють	`openclaw matrix verify status`	Повторно перевірте пристрій, а потім виконайте `openclaw matrix verify backup status`.
Відновлення резервної копії очікує або не працює	`openclaw matrix verify backup status`	Виконайте `openclaw matrix verify backup restore` або повторіть спробу з ключем відновлення.
Перехресне підписування або початкове налаштування виглядає некоректно	`openclaw matrix verify bootstrap`	За один прохід виправте захищене сховище, перехресне підписування та стан резервної копії.

Повне налаштування та конфігурація: Matrix

Overview

Mainstream messaging

Developer and self-hosted

Regional platforms

Configuration

Усунення несправностей каналів

Послідовність команд

Після оновлення

WhatsApp

Ознаки збоїв WhatsApp

Telegram

Ознаки збоїв Telegram

Discord

Ознаки збоїв Discord

Slack

Ознаки збоїв Slack

iMessage

Ознаки збоїв iMessage

Signal

Ознаки збоїв Signal

QQ Bot

Ознаки збоїв QQ Bot

Matrix

Ознаки збоїв Matrix

Пов’язані матеріали

​Послідовність команд

​Після оновлення

​WhatsApp

​Ознаки збоїв WhatsApp

​Telegram

​Ознаки збоїв Telegram

​Discord

​Ознаки збоїв Discord

​Slack

​Ознаки збоїв Slack

​iMessage

​Ознаки збоїв iMessage

​Signal

​Ознаки збоїв Signal

​QQ Bot

​Ознаки збоїв QQ Bot

​Matrix

​Ознаки збоїв Matrix

​Пов’язані матеріали

Послідовність команд

Після оновлення

WhatsApp

Ознаки збоїв WhatsApp

Telegram

Ознаки збоїв Telegram

Discord

Ознаки збоїв Discord

Slack

Ознаки збоїв Slack

iMessage

Ознаки збоїв iMessage

Signal

Ознаки збоїв Signal

QQ Bot

Ознаки збоїв QQ Bot

Matrix

Ознаки збоїв Matrix

Пов’язані матеріали