> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Устранение неполадок каналов Используйте эту страницу, если канал подключается, но работает неправильно. ## Последовательность команд Сначала выполните эти команды по порядку: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 theme={"theme":{"light":"min-light","dark":"min-dark"}} 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](https://docs2.openclaw.ai/ru/channels/whatsapp.md#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](https://docs2.openclaw.ai/ru/channels/telegram.md#troubleshooting) ## Discord ### Признаки сбоев Discord | Симптом | Самая быстрая проверка | Исправление | | - | - | - | | Бот в сети, но не отвечает на сервере | `openclaw channels status --probe` | Разрешите сервер и канал, а также проверьте разрешение на доступ к содержимому сообщений. | | Сообщения в группе игнорируются | Проверьте журналы на наличие отклонений из-за ограничения по упоминаниям | Упомяните бота или задайте для сервера или канала `requireMention: false`. | | Отображается набор текста или расход токенов, но сообщение Discord не появляется | Проверьте, является ли это событием фоновой комнаты или комнаты `message_tool` с явным включением, где модель не вызвала `message(action=send)` | Проверьте подробный журнал Gateway на наличие метаданных подавленной итоговой полезной нагрузки, проверьте `messages.groupChat.unmentionedInbound`, прочитайте раздел [События фоновой комнаты](https://docs2.openclaw.ai/ru/channels/ambient-room-events.md) или оставьте `messages.groupChat.visibleReplies: "automatic"` для обычных запросов в группе. | | Ответы в личных сообщениях отсутствуют | `openclaw pairing list discord` | Одобрите сопряжение для личных сообщений или скорректируйте их политику. | Полное руководство: [Устранение неполадок Discord](https://docs2.openclaw.ai/ru/channels/discord.md#troubleshooting) ## Slack ### Признаки сбоев Slack | Симптом | Самая быстрая проверка | Исправление | | - | - | - | | Режим сокетов подключён, но ответов нет | `openclaw channels status --probe` | Проверьте токен приложения, токен бота и необходимые области доступа; в конфигурациях на основе SecretRef следите за `botTokenStatus` / `appTokenStatus = configured_unavailable`. | | Личные сообщения заблокированы | `openclaw pairing list slack` | Одобрите сопряжение или смягчите политику личных сообщений. | | Сообщение канала игнорируется | Проверьте `groupPolicy` и список разрешённых каналов | Разрешите канал или измените политику на `open`. | Полное руководство: [Устранение неполадок Slack](https://docs2.openclaw.ai/ru/channels/slack.md#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](https://docs2.openclaw.ai/ru/channels/imessage.md#troubleshooting) ## Signal ### Признаки сбоев Signal | Симптом | Самая быстрая проверка | Исправление | | - | - | - | | Демон доступен, но бот не отвечает | `openclaw channels status --probe` | Проверьте URL демона `signal-cli`, учётную запись и режим приёма. | | Личные сообщения заблокированы | `openclaw pairing list signal` | Одобрите отправителя или скорректируйте политику личных сообщений. | | Ответы в группе не срабатывают | Проверьте список разрешённых групп и шаблоны упоминаний | Добавьте отправителя или группу либо смягчите ограничения. | Полное руководство: [Устранение неполадок Signal](https://docs2.openclaw.ai/ru/channels/signal.md#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](https://docs2.openclaw.ai/ru/channels/qqbot.md#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](https://docs2.openclaw.ai/ru/channels/matrix.md) ## Связанные разделы * [Сопряжение](https://docs2.openclaw.ai/ru/channels/pairing.md) * [Маршрутизация каналов](https://docs2.openclaw.ai/ru/channels/channel-routing.md) * [Устранение неполадок Gateway](https://docs2.openclaw.ai/ru/gateway/troubleshooting.md)