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

Эта страница пригодится, когда канал подключается, но ведёт себя неправильно.

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

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

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

Нормальное состояние:

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

Полное устранение неполадок: /channels/whatsapp#troubleshooting-quick

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

Полное устранение неполадок: /channels/telegram#troubleshooting

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

Полное устранение неполадок: /channels/discord#troubleshooting

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

Полное устранение неполадок: /channels/slack#troubleshooting

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

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

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

Полное устранение неполадок: /channels/signal#troubleshooting

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

Полное устранение неполадок: /channels/matrix#troubleshooting