Troubleshooting каналов

· 3 мин чтения · admin

Если канал не работает — начните с диагностики. Эта статья помогает быстро найти и исправить проблему.

Команды диагностики

Запускайте по порядку:

openclaw status                    # общий статус
openclaw gateway status            # статус Gateway
openclaw logs --follow             # логи в реальном времени
openclaw doctor                    # проверка конфигурации
openclaw channels status --probe   # диагностика каналов

Здоровый baseline:

  • Runtime: running
  • Connectivity probe: ok
  • Capability: read-only, write-capable или admin-capable

    • Telegram

    Симптом Проверка Решение
    Бот онлайн, но не отвечает в ЛС `openclaw pairing list telegram` Одобрить pairing или сменить dmPolicy
    Бот молчит в группе Проверить Privacy Mode + requireMention `/setprivacy` у BotFather, перезайти в группу
    Ошибки сети при отправке Логи на Telegram API ошибки Проверить DNS/IPv6/прокси к `api.telegram.org`
    Polling зависает `openclaw logs —follow` Настроить `pollingStallThresholdMs` или проверить прокси
    `setMyCommands` ошибка Логи на `BOT_COMMANDS_TOO_MUCH` Уменьшить количество команд плагинов
    После обновления блокирует `openclaw security audit` `openclaw doctor —fix` или заменить `@username` на числовые ID

    Google Chat

    Симптом Проверка Решение
    405 Method Not Allowed `openclaw config get channels.googlechat` Добавить конфиг канала
    Плагин не включён `openclaw plugins list \ grep googlechat` `plugins.entries.googlechat.enabled: true`
    Не приходят сообщения Логи + webhook URL в настройках Chat API Проверить публичный URL и event subscriptions

    WhatsApp

    Симптом Проверка Решение
    Подключён, но не отвечает в ЛС `openclaw pairing list whatsapp` Одобрить sender или сменить dmPolicy
    Групповые не приходят requireMention + mention patterns Упомянуть бота или ослабить mention
    Разлогинивание / реконнект `openclaw channels status —probe` Перелогиниться: `openclaw channels login —channel whatsapp`

    Slack

    Симптом Проверка Решение
    Socket connected, но нет ответов `openclaw channels status —probe` Проверить app token + bot token + scopes
    DM заблокированы `openclaw pairing list slack` Одобрить pairing или ослабить dmPolicy
    Канал игнорируется groupPolicy + channel allowlist Добавить канал в allowlist или `open`

    Discord

    Симптом Проверка Решение
    Бот онлайн, но guild не отвечает `openclaw channels status —probe` Разрешить guild/channel + включить Message Content Intent
    Групповые не приходят Логи на mention gating Упомянуть бота или `requireMention: false`
    DM не приходят `openclaw pairing list discord` Одобрить pairing

    Signal

    Симптом Проверка Решение
    Daemon доступен, но бот молчит `openclaw channels status —probe` Проверить `signal-cli` daemon URL/account
    DM заблокирован `openclaw pairing list signal` Одобрить sender
    Групповые не триггерятся group allowlist + mention patterns Добавить sender/group

    iMessage / BlueBubbles

    Симптом Проверка Решение
    Нет входящих событий Webhook/сервер reachability Исправить webhook URL или состояние BlueBubbles
    Отправка работает, приём нет macOS privacy permissions Передать TCC permissions, перезапустить
    DM заблокирован `openclaw pairing list bluebubbles` Одобрить pairing

    Matrix

    Симптом Проверка Решение
    Logged in, но игнорирует комнаты `openclaw channels status —probe` Проверить groupPolicy, room allowlist, mention
    DM не обрабатываются `openclaw pairing list matrix` Одобрить sender
    Шифрованные комнаты не работают `openclaw matrix verify status` Переверифицировать устройство

    Общие паттерны

    После обновления: openclaw doctor --fix — исправляет конфигурацию и мигрирует устаревшие настройки.

    Pairing код истёк: действуют 1 час. Напишите боту снова для нового.

    Канал не в списке: openclaw channels status — проверьте что канал enabled: true в конфиге.

    Что дальше

  • Конфигурация Gateway — общие настройки
  • Безопасность — защита Gateway