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

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

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

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

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

​
WhatsApp

​
Типові збої WhatsApp

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

​
Telegram

​
Типові збої Telegram

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

​
Discord

​
Типові збої Discord

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

​
Slack

​
Типові збої Slack

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

​
iMessage і BlueBubbles

​
Типові збої iMessage і BlueBubbles

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

​
Signal

​
Типові збої Signal

СимптомНайшвидша перевіркаВиправлення
Демон доступний, але бот мовчитьopenclaw channels status --probeПеревірте URL/обліковий запис демона signal-cli і режим отримання.
Приватні повідомлення заблокованоopenclaw pairing list signalПідтвердьте відправника або змініть політику приватних повідомлень.
Відповіді в групі не запускаютьсяПеревірте allowlist групи та шаблони згадокДодайте відправника/групу або послабте керування.
Повне усунення несправностей: /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, allowlist кімнат і керування згадками.
Приватні повідомлення не обробляютьсяopenclaw pairing list matrixПідтвердьте відправника або змініть політику приватних повідомлень.
Зашифровані кімнати не працюють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Виправте secret storage, cross-signing і стан резервної копії за один прохід.
Повне налаштування й конфігурація: Matrix