Перейти к основному содержанию

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

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

Командная лестница

Сначала выполните их по порядку:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Здоровая базовая линия:
  • Runtime: running
  • RPC probe: ok
  • Проверка канала показывает состояние connected/ready

WhatsApp

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

СимптомСамая быстрая проверкаИсправление
Подключено, но нет ответов на ЛСopenclaw pairing list whatsappОдобрите отправителя или переключите политику ЛС/allowlist.
Групповые сообщения игнорируютсяПроверьте requireMention и шаблоны упоминаний в конфигеУпомяните бота или ослабьте политику упоминаний для этой группы.
Случайные разрывы/циклы перелогинаopenclaw channels status --probe и логиПерелогиньтесь и проверьте, что каталог учётных данных исправен.
Полное устранение неполадок: /channels/whatsapp#troubleshooting-quick

Telegram

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

СимптомСамая быстрая проверкаИсправление
/start без пригодного потока ответовopenclaw pairing list telegramОдобрите сопряжение или измените политику ЛС.
Бот онлайн, но группа молчитПроверьте требование упоминаний и режим приватности ботаОтключите режим приватности для видимости в группе или упомяните бота.
Сбои отправки с сетевыми ошибкамиИзучите логи на ошибки вызовов API TelegramИсправьте маршрутизацию DNS/IPv6/прокси к api.telegram.org.
Обновились, и вас блокирует allowlistopenclaw security audit и allowlist конфигурацииВыполните openclaw doctor --fix или замените @username на числовые ID отправителей.
Полное устранение неполадок: /channels/telegram#troubleshooting

Discord

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

СимптомСамая быстрая проверкаИсправление
Бот онлайн, но нет ответов в гильдииopenclaw channels status --probeРазрешите гильдию/канал и проверьте Intent «Message Content».
Групповые сообщения игнорируютсяПроверьте логи на отбрасывания из‑за упоминанийУпомяните бота или задайте для гильдии/канала requireMention: false.
Нет ответов в ЛСopenclaw pairing list discordОдобрите сопряжение ЛС или скорректируйте политику ЛС.
Полное устранение неполадок: /channels/discord#troubleshooting

Slack

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

СимптомСамая быстрая проверкаИсправление
Socket mode подключён, но нет ответовopenclaw channels status --probeПроверьте app token + bot token и необходимые области доступа.
ЛС заблокированыopenclaw pairing list slackОдобрите сопряжение или ослабьте политику ЛС.
Сообщение в канале игнорируетсяПроверьте groupPolicy и allowlist каналовРазрешите канал или переключите политику на open.
Полное устранение неполадок: /channels/slack#troubleshooting

iMessage и BlueBubbles

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

СимптомСамая быстрая проверкаИсправление
Нет входящих событийПроверьте доступность webhook/сервера и разрешения приложенияИсправьте URL webhook или состояние сервера BlueBubbles.
Можно отправлять, но не получать на macOSПроверьте разрешения приватности macOS для автоматизации MessagesПовторно выдайте разрешения TCC и перезапустите процесс канала.
Отправитель ЛС заблокированopenclaw pairing list imessage или openclaw pairing list bluebubblesОдобрите сопряжение или обновите allowlist.
Полное устранение неполадок:

Signal

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

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

Matrix

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

СимптомСамая быстрая проверкаИсправление
Вход выполнен, но сообщения комнат игнорируютсяopenclaw channels status --probeПроверьте groupPolicy и allowlist комнат.
ЛС не обрабатываютсяopenclaw pairing list matrixОдобрите отправителя или скорректируйте политику ЛС.
Зашифрованные комнаты не работаютПроверьте криптомодуль и настройки шифрованияВключите поддержку шифрования и заново присоединитесь/синхронизируйте комнату.
Полное устранение неполадок: /channels/matrix#troubleshooting