Лестница команд
Сначала выполните эти команды по порядку:Runtime: runningConnectivity probe: okCapability: read-only,write-capableилиadmin-capable- Проверка канала показывает, что транспорт подключен и, где поддерживается,
worksилиaudit ok
После обновления
Используйте это, когда Telegram, iMessage, конфигурации эпохи BlueBubbles или другой канал Plugin исчезает после обновления.plugin load failed: dependency tree corrupted; run openclaw doctor --fix в openclaw status --all. Это означает, что канал настроен, но
путь настройки/загрузки Plugin наткнулся на поврежденное дерево зависимостей вместо регистрации
канала. openclaw doctor --fix удаляет устаревшие промежуточные каталоги зависимостей Plugin
и устаревшие теневые данные авторизации, затем openclaw gateway restart перезагружает
чистое состояние.
Сигнатуры сбоев 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. |
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 отправителей. |
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-комнат или оставьте messages.groupChat.visibleReplies: "automatic" для обычных групповых запросов. |
| Нет ответов в ЛС | openclaw pairing list discord | Одобрите привязку ЛС или скорректируйте политику ЛС. |
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. |
iMessage
Сигнатуры сбоев iMessage
| Симптом | Самая быстрая проверка | Исправление |
|---|---|---|
imsg отсутствует или падает не на macOS | openclaw channels status --probe --channel imessage | Запустите OpenClaw на Mac с Messages или используйте SSH-обертку для cliPath. |
| Можно отправлять, но нет приема на macOS | Проверьте разрешения конфиденциальности macOS для автоматизации Messages | Повторно выдайте разрешения TCC и перезапустите процесс канала. |
| Отправитель ЛС заблокирован | openclaw pairing list imessage | Одобрите привязку или обновите allowlist. |
Signal
Сигнатуры сбоев Signal
| Симптом | Самая быстрая проверка | Исправление |
|---|---|---|
| Daemon доступен, но бот молчит | openclaw channels status --probe | Проверьте URL/аккаунт daemon signal-cli и режим приема. |
| ЛС заблокированы | openclaw pairing list signal | Одобрите отправителя или скорректируйте политику ЛС. |
| Ответы в группе не срабатывают | Проверьте allowlist группы и шаблоны упоминаний | Добавьте отправителя/группу или ослабьте ограничения. |
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 может блокировать инициированные ботом сообщения без недавнего взаимодействия. |
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 | Исправьте хранилище секретов, кросс-подпись и состояние резервной копии за один проход. |