Устранение неполадок каналов

Используйте эту страницу, если канал подключается, но работает неправильно.

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

Сначала выполните эти команды по порядку:

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 или другой канал плагина.

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

Симптом	Самая быстрая проверка	Исправление
Подключение установлено, но ответов в личных сообщениях нет	`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

Признаки сбоев 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

Discord

Признаки сбоев Discord

Симптом	Самая быстрая проверка	Исправление
Бот в сети, но не отвечает на сервере	`openclaw channels status --probe`	Разрешите сервер и канал, а также проверьте разрешение на доступ к содержимому сообщений.
Сообщения в группе игнорируются	Проверьте журналы на наличие отклонений из-за ограничения по упоминаниям	Упомяните бота или задайте для сервера или канала `requireMention: false`.
Отображается набор текста или расход токенов, но сообщение Discord не появляется	Проверьте, является ли это событием фоновой комнаты или комнаты `message_tool` с явным включением, где модель не вызвала `message(action=send)`	Проверьте подробный журнал Gateway на наличие метаданных подавленной итоговой полезной нагрузки, проверьте `messages.groupChat.unmentionedInbound`, прочитайте раздел События фоновой комнаты или оставьте `messages.groupChat.visibleReplies: "automatic"` для обычных запросов в группе.
Ответы в личных сообщениях отсутствуют	`openclaw pairing list discord`	Одобрите сопряжение для личных сообщений или скорректируйте их политику.

Полное руководство: Устранение неполадок Discord

Slack

Признаки сбоев Slack

Симптом	Самая быстрая проверка	Исправление
Режим сокетов подключён, но ответов нет	`openclaw channels status --probe`	Проверьте токен приложения, токен бота и необходимые области доступа; в конфигурациях на основе SecretRef следите за `botTokenStatus` / `appTokenStatus = configured_unavailable`.
Личные сообщения заблокированы	`openclaw pairing list slack`	Одобрите сопряжение или смягчите политику личных сообщений.
Сообщение канала игнорируется	Проверьте `groupPolicy` и список разрешённых каналов	Разрешите канал или измените политику на `open`.

Полное руководство: Устранение неполадок Slack

iMessage

Признаки сбоев iMessage

Симптом	Самая быстрая проверка	Исправление
`imsg` отсутствует или не работает вне macOS	`openclaw channels status --probe --channel imessage`	Запустите OpenClaw на Mac с приложением Messages или используйте SSH-обёртку для `cliPath`.
На macOS отправка работает, но приём — нет	Проверьте разрешения конфиденциальности macOS для автоматизации Messages	Повторно предоставьте разрешения TCC и перезапустите процесс канала.
Отправитель личного сообщения заблокирован	`openclaw pairing list imessage`	Одобрите сопряжение или обновите список разрешённых отправителей.

Полное руководство: Устранение неполадок iMessage

Signal

Признаки сбоев Signal

Симптом	Самая быстрая проверка	Исправление
Демон доступен, но бот не отвечает	`openclaw channels status --probe`	Проверьте URL демона `signal-cli`, учётную запись и режим приёма.
Личные сообщения заблокированы	`openclaw pairing list signal`	Одобрите отправителя или скорректируйте политику личных сообщений.
Ответы в группе не срабатывают	Проверьте список разрешённых групп и шаблоны упоминаний	Добавьте отправителя или группу либо смягчите ограничения.

Полное руководство: Устранение неполадок Signal

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

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

Overview

Mainstream messaging

Developer and self-hosted

Regional platforms

Configuration

Устранение неполадок каналов

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

После обновления

WhatsApp

Признаки сбоев WhatsApp

Telegram

Признаки сбоев Telegram

Discord

Признаки сбоев Discord

Slack

Признаки сбоев Slack

iMessage

Признаки сбоев iMessage

Signal

Признаки сбоев Signal

QQ Bot

Признаки сбоев QQ Bot

Matrix

Признаки сбоев Matrix

Связанные разделы

​Последовательность команд

​После обновления

​WhatsApp

​Признаки сбоев WhatsApp

​Telegram

​Признаки сбоев Telegram

​Discord

​Признаки сбоев Discord

​Slack

​Признаки сбоев Slack

​iMessage

​Признаки сбоев iMessage

​Signal

​Признаки сбоев Signal

​QQ Bot

​Признаки сбоев QQ Bot

​Matrix

​Признаки сбоев Matrix

​Связанные разделы

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

После обновления

WhatsApp

Признаки сбоев WhatsApp

Telegram

Признаки сбоев Telegram

Discord

Признаки сбоев Discord

Slack

Признаки сбоев Slack

iMessage

Признаки сбоев iMessage

Signal

Признаки сбоев Signal

QQ Bot

Признаки сбоев QQ Bot

Matrix

Признаки сбоев Matrix

Связанные разделы