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 или другой канал плагина.
openclaw status --allopenclaw doctor --fixopenclaw gateway restartopenclaw 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
Признаки сбоев 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
Связанные разделы
Was this useful?
