--- read_when: - Транспорт канала сообщает о подключении, но ответы не отправляются - Перед подробной документацией по провайдерам необходимо выполнить проверки для конкретного канала summary: Быстрое устранение неполадок на уровне каналов с характерными для каждого канала признаками сбоев и способами их устранения title: Устранение неполадок каналов x-i18n: generated_at: "2026-07-13T17:56:48Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 24 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 или другой канал плагина. ```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`. Это означает, что канал настроен, но при настройке или загрузке плагина вместо регистрации канала было обнаружено повреждённое дерево зависимостей. `openclaw doctor --fix` удаляет устаревшие символические ссылки зависимостей среды выполнения плагина и устаревшие теневые данные аутентификации, после чего `openclaw gateway restart` повторно загружает чистое состояние. ## WhatsApp ### Признаки сбоев WhatsApp | Симптом | Самая быстрая проверка | Исправление | | ----------------------------------- | --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | Подключение установлено, но ответов в личных сообщениях нет | `openclaw pairing list whatsapp` | Одобрите отправителя либо измените политику личных сообщений или список разрешённых отправителей. | | Сообщения в группе игнорируются | Проверьте `requireMention` и шаблоны упоминаний в конфигурации | Упомяните бота или смягчите политику упоминаний для этой группы. | | Вход по QR-коду завершается по тайм-ауту с кодом 408 | Проверьте переменные среды `HTTPS_PROXY` / `HTTP_PROXY` для Gateway | Настройте доступный прокси-сервер; используйте `NO_PROXY` только для обхода прокси. | | Случайные циклы отключения и повторного входа | `openclaw channels status --probe` и журналы | Недавние переподключения отмечаются, даже если сейчас соединение установлено; наблюдайте за журналами, перезапустите Gateway, а если нестабильность сохранится — повторно привяжите учётную запись. | | Цикл `status=408 Request Time-out` | Проверка, журналы, doctor, затем состояние Gateway | Сначала устраните проблемы с подключением или синхронизацией времени на хосте; если цикл сохраняется, создайте резервную копию данных аутентификации и повторно привяжите учётную запись. | | Ответы поступают с задержкой в несколько секунд или минут | `openclaw doctor --fix` | Doctor останавливает проверенные устаревшие локальные клиенты TUI, если они ухудшают работу цикла событий Gateway. | Полное руководство: [Устранение неполадок WhatsApp](/ru/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 от плагинов, Skills и пользовательских настроек либо отключите встроенные меню. | | После обновления список разрешённых отправителей блокирует вас | `openclaw security audit` и списки разрешений в конфигурации | Выполните `openclaw doctor --fix` или замените `@username` числовыми идентификаторами отправителей. | Полное руководство: [Устранение неполадок Telegram](/ru/channels/telegram#troubleshooting) ## Discord ### Признаки сбоев Discord | Симптом | Самая быстрая проверка | Исправление | | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Бот в сети, но не отвечает на сервере | `openclaw channels status --probe` | Разрешите сервер и канал, а также проверьте разрешение на доступ к содержимому сообщений. | | Сообщения в группе игнорируются | Проверьте журналы на наличие отклонений из-за ограничения по упоминаниям | Упомяните бота или задайте для сервера или канала `requireMention: false`. | | Отображается набор текста или расход токенов, но сообщение Discord не появляется | Проверьте, является ли это событием фоновой комнаты или комнаты `message_tool` с явным включением, где модель не вызвала `message(action=send)` | Проверьте подробный журнал Gateway на наличие метаданных подавленной итоговой полезной нагрузки, проверьте `messages.groupChat.unmentionedInbound`, прочитайте раздел [События фоновой комнаты](/ru/channels/ambient-room-events) или оставьте `messages.groupChat.visibleReplies: "automatic"` для обычных запросов в группе. | | Ответы в личных сообщениях отсутствуют | `openclaw pairing list discord` | Одобрите сопряжение для личных сообщений или скорректируйте их политику. | Полное руководство: [Устранение неполадок Discord](/ru/channels/discord#troubleshooting) ## Slack ### Признаки сбоев Slack | Симптом | Самая быстрая проверка | Исправление | | -------------------------------------- | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | Режим сокетов подключён, но ответов нет | `openclaw channels status --probe` | Проверьте токен приложения, токен бота и необходимые области доступа; в конфигурациях на основе SecretRef следите за `botTokenStatus` / `appTokenStatus = configured_unavailable`. | | Личные сообщения заблокированы | `openclaw pairing list slack` | Одобрите сопряжение или смягчите политику личных сообщений. | | Сообщение канала игнорируется | Проверьте `groupPolicy` и список разрешённых каналов | Разрешите канал или измените политику на `open`. | Полное руководство: [Устранение неполадок Slack](/ru/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](/ru/channels/imessage#troubleshooting) ## Signal ### Признаки сбоев Signal | Симптом | Самая быстрая проверка | Исправление | | ------------------------------- | ------------------------------------------ | -------------------------------------------------------- | | Демон доступен, но бот не отвечает | `openclaw channels status --probe` | Проверьте URL демона `signal-cli`, учётную запись и режим приёма. | | Личные сообщения заблокированы | `openclaw pairing list signal` | Одобрите отправителя или скорректируйте политику личных сообщений. | | Ответы в группе не срабатывают | Проверьте список разрешённых групп и шаблоны упоминаний | Добавьте отправителя или группу либо смягчите ограничения. | Полное руководство: [Устранение неполадок Signal](/ru/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](/ru/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](/ru/channels/matrix) ## Связанные разделы - [Сопряжение](/ru/channels/pairing) - [Маршрутизация каналов](/ru/channels/channel-routing) - [Устранение неполадок Gateway](/ru/gateway/troubleshooting)