Configuration
Устранение неполадок каналов
Используйте эту страницу, когда канал подключается, но поведение неверное.
Лестница команд
Сначала выполните эти команды по порядку:
openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probeИсправная базовая картина:
Runtime: runningConnectivity probe: okCapability: read-only,write-capableилиadmin-capable- Проверка канала показывает, что транспорт подключен и, где поддерживается,
worksилиaudit ok
После обновления
Используйте это, когда Telegram, iMessage, конфигурации эпохи BlueBubbles или другой канал Plugin исчезает после обновления.
openclaw status --allopenclaw doctor --fixopenclaw gateway restartopenclaw status --allИщите 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. |
Полное устранение неполадок: устранение неполадок WhatsApp
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
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 |
Одобрите привязку ЛС или скорректируйте политику ЛС. |
Полное устранение неполадок: устранение неполадок 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. |
Полное устранение неполадок: устранение неполадок Slack
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 группы и шаблоны упоминаний | Добавьте отправителя/группу или ослабьте ограничения. |
Полное устранение неполадок: устранение неполадок Signal
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
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
См. также
Was this useful?
