Перейти до основного вмісту

Усунення несправностей каналу

Використовуйте цю сторінку, коли канал підключається, але працює неправильно.

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

Спочатку виконайте їх у такому порядку:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Ознаки справного базового стану:
  • Runtime: running
  • Connectivity probe: ok
  • Capability: read-only, write-capable або admin-capable
  • Перевірка каналу показує, що транспорт підключений і, де це підтримується, works або audit ok

WhatsApp

Ознаки збоїв у WhatsApp

СимптомНайшвидша перевіркаВиправлення
Підключено, але немає відповідей у DMopenclaw pairing list whatsappПідтвердьте відправника або змініть політику DM/список дозволених.
Повідомлення в групі ігноруютьсяПеревірте requireMention і шаблони згадок у конфігураціїЗгадайте бота або послабте політику згадок для цієї групи.
Випадкові цикли відключення/повторного входуopenclaw channels status --probe + журналиУвійдіть знову та переконайтеся, що каталог облікових даних справний.
Повне усунення несправностей: /channels/whatsapp#troubleshooting

Telegram

Ознаки збоїв у Telegram

СимптомНайшвидша перевіркаВиправлення
/start, але немає придатного для використання потоку відповідейopenclaw pairing list telegramПідтвердьте сполучення або змініть політику DM.
Бот онлайн, але група мовчитьПеревірте вимогу згадки та режим приватності ботаВимкніть режим приватності для видимості в групі або згадайте бота.
Помилки надсилання з мережевими помилкамиПерегляньте журнали на помилки викликів Telegram APIВиправте маршрутизацію DNS/IPv6/proxy до api.telegram.org.
setMyCommands відхиляється під час запускуПерегляньте журнали на BOT_COMMANDS_TOO_MUCHЗменште кількість команд Telegram від Plugin/Skills/власних команд або вимкніть вбудовані меню.
Після оновлення список дозволених вас блокуєopenclaw security audit і списки дозволених у конфігураціїВиконайте openclaw doctor --fix або замініть @username на числові ідентифікатори відправників.
Повне усунення несправностей: /channels/telegram#troubleshooting

Discord

Ознаки збоїв у Discord

СимптомНайшвидша перевіркаВиправлення
Бот онлайн, але не відповідає в guildopenclaw channels status --probeДозвольте guild/channel і перевірте intent вмісту повідомлень.
Повідомлення в групі ігноруютьсяПеревірте журнали на відхилення через згадкиЗгадайте бота або встановіть requireMention: false для guild/channel.
Немає відповідей у DMopenclaw pairing list discordПідтвердьте сполучення DM або скоригуйте політику DM.
Повне усунення несправностей: /channels/discord#troubleshooting

Slack

Ознаки збоїв у Slack

СимптомНайшвидша перевіркаВиправлення
Socket mode підключено, але немає відповідейopenclaw channels status --probeПеревірте токен застосунку, токен бота та потрібні дозволи; зверніть увагу на botTokenStatus / appTokenStatus = configured_unavailable у налаштуваннях на основі SecretRef.
DM заблокованіopenclaw pairing list slackПідтвердьте сполучення або послабте політику DM.
Повідомлення в каналі ігноруєтьсяПеревірте groupPolicy і список дозволених каналівДозвольте канал або перемкніть політику на open.
Повне усунення несправностей: /channels/slack#troubleshooting

iMessage і BlueBubbles

Ознаки збоїв у iMessage і BlueBubbles

СимптомНайшвидша перевіркаВиправлення
Немає вхідних подійПеревірте доступність Webhook/сервера та дозволи застосункуВиправте URL Webhook або стан сервера BlueBubbles.
Можна надсилати, але немає прийому на macOSПеревірте дозволи конфіденційності macOS для автоматизації MessagesПовторно надайте дозволи TCC і перезапустіть процес каналу.
Відправника DM заблокованоopenclaw pairing list imessage або openclaw pairing list bluebubblesПідтвердьте сполучення або оновіть список дозволених.
Повне усунення несправностей:

Signal

Ознаки збоїв у Signal

СимптомНайшвидша перевіркаВиправлення
Демон доступний, але бот мовчитьopenclaw channels status --probeПеревірте URL/обліковий запис демона signal-cli і режим прийому.
DM заблокованоopenclaw pairing list signalПідтвердьте відправника або скоригуйте політику DM.
Відповіді в групі не спрацьовуютьПеревірте список дозволених груп і шаблони згадокДодайте відправника/групу або послабте фільтрацію.
Повне усунення несправностей: /channels/signal#troubleshooting

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 може блокувати повідомлення, ініційовані ботом, без недавньої взаємодії.
Повне усунення несправностей: /channels/qqbot#troubleshooting

Matrix

Ознаки збоїв у Matrix

СимптомНайшвидша перевіркаВиправлення
Вхід виконано, але повідомлення кімнати ігноруютьсяopenclaw channels status --probeПеревірте groupPolicy, список дозволених кімнат і фільтрацію за згадками.
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 і стан резервної копії.
Повне налаштування і конфігурація: Matrix