---
read_when:
    - Транспорт каналу показує, що підключений, але відповіді не надсилаються
    - Перед поглибленим розглядом документації провайдера потрібні перевірки, специфічні для каналу
summary: Швидке усунення несправностей на рівні каналу з типовими ознаками збоїв і способами виправлення
title: Усунення несправностей каналу
x-i18n:
    generated_at: "2026-04-20T06:31:08Z"
    model: gpt-5.4
    provider: openai
    source_hash: 0aef31742cd5cc4af3fa3d3ea1acba51875ad4a1423c0e8c87372c3df31b0528
    source_path: channels/troubleshooting.md
    workflow: 15
---

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

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

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

Спочатку виконайте їх у такому порядку:

```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`

## WhatsApp

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

| Симптом                         | Найшвидша перевірка                                | Виправлення                                                  |
| ------------------------------- | -------------------------------------------------- | ------------------------------------------------------------ |
| Підключено, але немає відповідей у DM | `openclaw pairing list whatsapp`                   | Підтвердьте відправника або змініть політику DM/список дозволених. |
| Повідомлення в групі ігноруються | Перевірте `requireMention` і шаблони згадок у конфігурації | Згадайте бота або послабте політику згадок для цієї групи.   |
| Випадкові цикли відключення/повторного входу | `openclaw channels status --probe` + журнали       | Увійдіть знову та переконайтеся, що каталог облікових даних справний. |

Повне усунення несправностей: [/channels/whatsapp#troubleshooting](/uk/channels/whatsapp#troubleshooting)

## Telegram

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

| Симптом                             | Найшвидша перевірка                          | Виправлення                                                              |
| ----------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------ |
| `/start`, але немає придатного для використання потоку відповідей | `openclaw pairing list telegram`            | Підтвердьте сполучення або змініть політику DM.                          |
| Бот онлайн, але група мовчить       | Перевірте вимогу згадки та режим приватності бота | Вимкніть режим приватності для видимості в групі або згадайте бота.      |
| Помилки надсилання з мережевими помилками | Перегляньте журнали на помилки викликів Telegram API | Виправте маршрутизацію DNS/IPv6/proxy до `api.telegram.org`.             |
| `setMyCommands` відхиляється під час запуску | Перегляньте журнали на `BOT_COMMANDS_TOO_MUCH` | Зменште кількість команд Telegram від Plugin/Skills/власних команд або вимкніть вбудовані меню. |
| Після оновлення список дозволених вас блокує | `openclaw security audit` і списки дозволених у конфігурації | Виконайте `openclaw doctor --fix` або замініть `@username` на числові ідентифікатори відправників. |

Повне усунення несправностей: [/channels/telegram#troubleshooting](/uk/channels/telegram#troubleshooting)

## Discord

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

| Симптом                         | Найшвидша перевірка              | Виправлення                                              |
| ------------------------------- | -------------------------------- | -------------------------------------------------------- |
| Бот онлайн, але не відповідає в guild | `openclaw channels status --probe` | Дозвольте guild/channel і перевірте intent вмісту повідомлень. |
| Повідомлення в групі ігноруються | Перевірте журнали на відхилення через згадки | Згадайте бота або встановіть `requireMention: false` для guild/channel. |
| Немає відповідей у DM           | `openclaw pairing list discord`  | Підтвердьте сполучення DM або скоригуйте політику DM.    |

Повне усунення несправностей: [/channels/discord#troubleshooting](/uk/channels/discord#troubleshooting)

## Slack

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

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

Повне усунення несправностей: [/channels/slack#troubleshooting](/uk/channels/slack#troubleshooting)

## iMessage і BlueBubbles

### Ознаки збоїв у iMessage і BlueBubbles

| Симптом                          | Найшвидша перевірка                                                  | Виправлення                                           |
| -------------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------- |
| Немає вхідних подій              | Перевірте доступність Webhook/сервера та дозволи застосунку          | Виправте URL Webhook або стан сервера BlueBubbles.    |
| Можна надсилати, але немає прийому на macOS | Перевірте дозволи конфіденційності macOS для автоматизації Messages | Повторно надайте дозволи TCC і перезапустіть процес каналу. |
| Відправника DM заблоковано       | `openclaw pairing list imessage` або `openclaw pairing list bluebubbles` | Підтвердьте сполучення або оновіть список дозволених. |

Повне усунення несправностей:

- [/channels/imessage#troubleshooting](/uk/channels/imessage#troubleshooting)
- [/channels/bluebubbles#troubleshooting](/uk/channels/bluebubbles#troubleshooting)

## Signal

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

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

Повне усунення несправностей: [/channels/signal#troubleshooting](/uk/channels/signal#troubleshooting)

## QQ Bot

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

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

Повне усунення несправностей: [/channels/qqbot#troubleshooting](/uk/channels/qqbot#troubleshooting)

## Matrix

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

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

Повне налаштування і конфігурація: [Matrix](/uk/channels/matrix)
