--- read_when: - Транспорт каналу повідомляє про підключення, але відповіді не надсилаються - Перш ніж заглиблюватися в документацію провайдера, потрібно виконати перевірки, специфічні для каналу summary: Швидке усунення несправностей на рівні каналів із характерними для кожного каналу ознаками збоїв і способами їх виправлення title: Усунення несправностей каналів x-i18n: generated_at: "2026-07-12T13:00:48Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: d2699b48ed6ab1f702789d2180daa43aed6ee83023889d0d8821faceb9a943b5 source_path: channels/troubleshooting.md workflow: 16 --- Використовуйте цю сторінку, коли канал підключається, але працює неправильно. ## Послідовність команд Спочатку виконайте ці команди по черзі: ```bash 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. ```bash 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 ### Ознаки збоїв 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](/uk/channels/whatsapp#troubleshooting) ## Telegram ### Ознаки збоїв 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](/uk/channels/telegram#troubleshooting) ## Discord ### Ознаки збоїв Discord | Симптом | Найшвидша перевірка | Виправлення | | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Бот у мережі, але не відповідає на сервері | `openclaw channels status --probe` | Дозвольте сервер або канал і перевірте дозвіл на доступ до вмісту повідомлень. | | Групові повідомлення ігноруються | Перевірте журнали на наявність відхилень через обмеження згадок | Згадайте бота або встановіть для сервера чи каналу `requireMention: false`. | | Є індикація набору тексту або використання токенів, але немає повідомлення Discord | Перевірте, чи це фонова подія кімнати або кімната з увімкненим `message_tool`, де модель не викликала `message(action=send)` | Перевірте докладний журнал Gateway на наявність метаданих приглушеного кінцевого корисного навантаження, перевірте `messages.groupChat.unmentionedInbound`, прочитайте [Фонові події кімнати](/uk/channels/ambient-room-events) або залиште `messages.groupChat.visibleReplies: "automatic"` для звичайних групових запитів. | | Відсутні відповіді у приватних повідомленнях | `openclaw pairing list discord` | Схваліть сполучення приватних повідомлень або змініть їхню політику. | Повний посібник з усунення несправностей: [Усунення несправностей Discord](/uk/channels/discord#troubleshooting) ## Slack ### Ознаки збоїв Slack | Симптом | Найшвидша перевірка | Виправлення | | -------------------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Режим сокетів підключено, але відповідей немає | `openclaw channels status --probe` | Перевірте токен застосунку, токен бота й необхідні області доступу; у конфігураціях на основі SecretRef стежте за `botTokenStatus` / `appTokenStatus = configured_unavailable`. | | Приватні повідомлення заблоковано | `openclaw pairing list slack` | Схваліть сполучення або послабте політику приватних повідомлень. | | Повідомлення каналу ігнорується | Перевірте `groupPolicy` і список дозволених каналів | Дозвольте канал або змініть політику на `open`. | Повний посібник з усунення несправностей: [Усунення несправностей Slack](/uk/channels/slack#troubleshooting) ## iMessage ### Ознаки збоїв iMessage | Симптом | Найшвидша перевірка | Виправлення | | -------------------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | `imsg` відсутній або не працює не на macOS | `openclaw channels status --probe --channel imessage` | Запустіть OpenClaw на Mac із Messages або використовуйте обгортку SSH для `cliPath`. | | Надсилання працює, але отримання на macOS — ні | Перевірте дозволи конфіденційності macOS для автоматизації Messages | Повторно надайте дозволи TCC і перезапустіть процес каналу. | | Відправника приватного повідомлення заблоковано | `openclaw pairing list imessage` | Схваліть сполучення або оновіть список дозволених. | Повний посібник з усунення несправностей: [Усунення несправностей iMessage](/uk/channels/imessage#troubleshooting) ## Signal ### Ознаки збоїв Signal | Симптом | Найшвидша перевірка | Виправлення | | -------------------------------------- | ------------------------------------------------ | -------------------------------------------------------------------------- | | Демон доступний, але бот не відповідає | `openclaw channels status --probe` | Перевірте URL демона `signal-cli`, обліковий запис і режим отримання. | | Приватні повідомлення заблоковано | `openclaw pairing list signal` | Схваліть відправника або змініть політику приватних повідомлень. | | Групові відповіді не спрацьовують | Перевірте список дозволених груп і шаблони згадок | Додайте відправника або групу чи послабте обмеження. | Повний посібник з усунення несправностей: [Усунення несправностей Signal](/uk/channels/signal#troubleshooting) ## 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](/uk/channels/qqbot#troubleshooting) ## 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](/uk/channels/matrix) ## Пов’язані матеріали - [Сполучення](/uk/channels/pairing) - [Маршрутизація каналів](/uk/channels/channel-routing) - [Усунення несправностей Gateway](/uk/gateway/troubleshooting)