> ## 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 или другой канал Plugin исчезает после обновления. ```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`. Это означает, что канал настроен, но путь настройки/загрузки Plugin наткнулся на поврежденное дерево зависимостей вместо регистрации канала. `openclaw doctor --fix` удаляет устаревшие промежуточные каталоги зависимостей Plugin и устаревшие теневые данные авторизации, затем `openclaw gateway restart` перезагружает чистое состояние. ## WhatsApp ### Сигнатуры сбоев WhatsApp | Симптом | Самая быстрая проверка | Исправление | | ------------------------------------------- | -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Подключен, но нет ответов в ЛС | `openclaw pairing list whatsapp` | Одобрите отправителя или измените политику/allowlist для ЛС. | | Групповые сообщения игнорируются | Проверьте `requireMention` + шаблоны упоминаний в конфигурации | Упомяните бота или ослабьте политику упоминаний для этой группы. | | Вход по QR истекает с 408 | Проверьте env 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](/ru/channels/whatsapp#troubleshooting) ## Telegram ### Сигнатуры сбоев Telegram | Симптом | Самая быстрая проверка | Исправление | | ---------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `/start`, но нет пригодного потока ответов | `openclaw pairing list telegram` | Одобрите привязку или измените политику ЛС. | | Бот онлайн, но группа молчит | Проверьте требование упоминания и режим приватности бота | Отключите режим приватности для видимости в группе или упомяните бота. | | Сбои отправки с сетевыми ошибками | Проверьте журналы на сбои вызовов Telegram API | Исправьте маршрутизацию DNS/IPv6/прокси к `api.telegram.org`. | | При запуске сообщается `getMe returned 401` | Проверьте настроенный источник токена | Скопируйте заново или сгенерируйте заново токен BotFather и обновите `botToken`, `tokenFile` или `TELEGRAM_BOT_TOKEN` аккаунта по умолчанию. | | Polling зависает или медленно переподключается | `openclaw logs --follow` для диагностики polling | Обновитесь; если перезапуски являются ложными срабатываниями, настройте `pollingStallThresholdMs`. Постоянные зависания все еще указывают на прокси/DNS/IPv6. | | `setMyCommands` отклоняется при запуске | Проверьте журналы на `BOT_COMMANDS_TOO_MUCH` | Сократите команды Telegram из Plugin/skill/пользовательские команды или отключите нативные меню. | | После обновления allowlist блокирует вас | `openclaw security audit` и allowlist в конфигурации | Запустите `openclaw doctor --fix` или замените `@username` числовыми ID отправителей. | Полное устранение неполадок: [устранение неполадок Telegram](/ru/channels/telegram#troubleshooting) ## Discord ### Сигнатуры сбоев Discord | Симптом | Самая быстрая проверка | Исправление | | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Бот онлайн, но нет ответов в guild | `openclaw channels status --probe` | Разрешите guild/канал и проверьте intent содержимого сообщений. | | Групповые сообщения игнорируются | Проверьте журналы на отбрасывания из-за ограничений упоминаний | Упомяните бота или задайте для guild/канала `requireMention: false`. | | Есть набор текста/использование токенов, но нет сообщения Discord | Проверьте, является ли это событием ambient-комнаты или комнатой `message_tool` с opt-in, где модель пропустила `message(action=send)` | Проверьте подробный журнал Gateway на метаданные подавленной финальной нагрузки, проверьте `messages.groupChat.unmentionedInbound`, прочитайте [события ambient-комнат](/ru/channels/ambient-room-events) или оставьте `messages.groupChat.visibleReplies: "automatic"` для обычных групповых запросов. | | Нет ответов в ЛС | `openclaw pairing list discord` | Одобрите привязку ЛС или скорректируйте политику ЛС. | Полное устранение неполадок: [устранение неполадок Discord](/ru/channels/discord#troubleshooting) ## Slack ### Сигнатуры сбоев Slack | Симптом | Самая быстрая проверка | Исправление | | ------------------------------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Socket mode подключен, но ответов нет | `openclaw channels status --probe` | Проверьте app token + bot token и необходимые scopes; следите за `botTokenStatus` / `appTokenStatus = configured_unavailable` в настройках на базе SecretRef. | | ЛС заблокированы | `openclaw pairing list slack` | Одобрите привязку или ослабьте политику ЛС. | | Сообщение в канале игнорируется | Проверьте `groupPolicy` и allowlist канала | Разрешите канал или переключите политику на `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` | Одобрите привязку или обновите allowlist. | Полное устранение неполадок: * [устранение неполадок iMessage](/ru/channels/imessage#troubleshooting) ## Signal ### Сигнатуры сбоев Signal | Симптом | Самая быстрая проверка | Исправление | | ------------------------------ | ----------------------------------------------- | --------------------------------------------------------- | | Daemon доступен, но бот молчит | `openclaw channels status --probe` | Проверьте URL/аккаунт daemon `signal-cli` и режим приема. | | ЛС заблокированы | `openclaw pairing list signal` | Одобрите отправителя или скорректируйте политику ЛС. | | Ответы в группе не срабатывают | Проверьте allowlist группы и шаблоны упоминаний | Добавьте отправителя/группу или ослабьте ограничения. | Полное устранение неполадок: [устранение неполадок Signal](/ru/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 может блокировать инициированные ботом сообщения без недавнего взаимодействия. | Полное устранение неполадок: [устранение неполадок 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` или запустите повторно с ключом восстановления. | | Кросс-подпись/bootstrap выглядит неверно | `openclaw matrix verify bootstrap` | Исправьте хранилище секретов, кросс-подпись и состояние резервной копии за один проход. | Полная настройка и конфигурация: [Matrix](/ru/channels/matrix) ## См. также * [Сопряжение](/ru/channels/pairing) * [Маршрутизация каналов](/ru/channels/channel-routing) * [Устранение неполадок Gateway](/ru/gateway/troubleshooting)