Драбина команд
Спочатку виконайте їх у такому порядку:Runtime: runningConnectivity probe: okCapability: read-only,write-capableабоadmin-capable- Перевірка каналу показує, що транспорт підключено і, де підтримується,
worksабоaudit ok
Після оновлення
Використовуйте це, коли Telegram, iMessage, конфіги епохи BlueBubbles або інший канал Plugin зникає після оновлення.plugin load failed: dependency tree corrupted; run openclaw doctor --fix у openclaw status --all. Це означає, що канал налаштовано, але
шлях налаштування/завантаження Plugin натрапив на пошкоджене дерево залежностей замість реєстрації
каналу. openclaw doctor --fix видаляє застарілі проміжні
каталоги залежностей Plugin і застарілі тіні автентифікації, після чого openclaw gateway restart перезавантажує
чистий стан.
Сигнатури збоїв WhatsApp
| Симптом | Найшвидша перевірка | Виправлення |
|---|---|---|
| Підключено, але немає відповідей у DM | openclaw pairing list whatsapp | Схваліть відправника або змініть політику/список дозволених для DM. |
| Повідомлення групи ігноруються | Перевірте requireMention + шаблони згадок у конфігу | Згадайте бота або послабте політику згадок для цієї групи. |
| Вхід через QR завершується тайм-аутом із 408 | Перевірте змінні середовища 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. |
Telegram
Сигнатури збоїв Telegram
| Симптом | Найшвидша перевірка | Виправлення |
|---|---|---|
/start, але немає придатного потоку відповідей | openclaw pairing list telegram | Схваліть прив’язування або змініть політику DM. |
| Бот онлайн, але група мовчить | Перевірте вимогу згадки та режим приватності бота | Вимкніть режим приватності для видимості в групі або згадайте бота. |
| Помилки надсилання з мережевими помилками | Перегляньте журнали щодо збоїв викликів Telegram API | Виправте маршрутизацію 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 від Plugin/skill/користувацьких команд або вимкніть нативні меню. |
| Після оновлення список дозволених блокує вас | openclaw security audit і списки дозволених у конфігу | Запустіть openclaw doctor --fix або замініть @username на числові ID відправників. |
Discord
Сигнатури збоїв Discord
| Симптом | Найшвидша перевірка | Виправлення |
|---|---|---|
| Бот онлайн, але немає відповідей у гільдії | openclaw channels status --probe | Дозвольте гільдію/канал і перевірте intent вмісту повідомлень. |
| Повідомлення групи ігноруються | Перевірте журнали щодо відкидань через шлюз згадок | Згадайте бота або встановіть для гільдії/каналу requireMention: false. |
| Є введення/використання токенів, але немає повідомлення Discord | Перевірте, чи це подія ambient-кімнати або кімната message_tool з явною згодою, де модель пропустила message(action=send) | Перегляньте детальний журнал Gateway щодо придушених метаданих фінального payload, перевірте messages.groupChat.unmentionedInbound, прочитайте Події ambient-кімнати або залиште messages.groupChat.visibleReplies: "automatic" для звичайних групових запитів. |
| Відсутні відповіді в DM | openclaw pairing list discord | Схваліть прив’язування DM або скоригуйте політику DM. |
Slack
Сигнатури збоїв Slack
| Симптом | Найшвидша перевірка | Виправлення |
|---|---|---|
| Socket mode підключено, але немає відповідей | openclaw channels status --probe | Перевірте app token + bot token і потрібні scopes; стежте за botTokenStatus / appTokenStatus = configured_unavailable у налаштуваннях на базі SecretRef. |
| DM заблоковані | openclaw pairing list slack | Схваліть прив’язування або послабте політику DM. |
| Повідомлення каналу ігнорується | Перевірте groupPolicy і список дозволених каналів | Дозвольте канал або змініть політику на open. |
iMessage
Сигнатури збоїв iMessage
| Симптом | Найшвидша перевірка | Виправлення |
|---|---|---|
imsg відсутній або завершується помилкою не на macOS | openclaw channels status --probe --channel imessage | Запустіть OpenClaw на Mac із Messages або використовуйте SSH-обгортку для cliPath. |
| Можна надсилати, але немає отримання на macOS | Перевірте дозволи приватності macOS для автоматизації Messages | Надайте дозволи TCC повторно і перезапустіть процес каналу. |
| Відправника DM заблоковано | openclaw pairing list imessage | Схваліть прив’язування або оновіть список дозволених. |
Signal
Сигнатури збоїв Signal
| Симптом | Найшвидша перевірка | Виправлення |
|---|---|---|
| Daemon доступний, але бот мовчить | openclaw channels status --probe | Перевірте URL/обліковий запис daemon signal-cli і режим отримання. |
| DM заблоковано | openclaw pairing list signal | Схваліть відправника або скоригуйте політику DM. |
| Відповіді групи не запускаються | Перевірте список дозволених груп і шаблони згадок | Додайте відправника/групу або послабте обмеження. |
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 може блокувати повідомлення, ініційовані ботом, без нещодавньої взаємодії. |
Matrix
Ознаки збоїв Matrix
| Симптом | Найшвидша перевірка | Виправлення |
|---|---|---|
| Увійшов у систему, але ігнорує повідомлення кімнати | openclaw channels status --probe | Перевірте groupPolicy, allowlist кімнат і обмеження за згадками. |
| DM не обробляються | openclaw pairing list matrix | Схваліть відправника або налаштуйте політику DM. |
| Зашифровані кімнати не працюють | openclaw matrix verify status | Повторно підтвердьте пристрій, потім перевірте openclaw matrix verify backup status. |
| Відновлення резервної копії очікує або зламане | openclaw matrix verify backup status | Запустіть openclaw matrix verify backup restore або повторіть із ключем відновлення. |
| Cross-signing/bootstrap виглядає неправильно | openclaw matrix verify bootstrap | Відновіть сховище секретів, cross-signing і стан резервної копії за один прохід. |