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 або інший канал Plugin.
openclaw status --allopenclaw doctor --fixopenclaw gateway restartopenclaw status --allШукайте plugin load failed: dependency tree corrupted; run openclaw doctor --fix у виводі openclaw status --all. Це означає, що канал налаштовано, але під час налаштування або завантаження Plugin виявлено пошкоджене дерево залежностей, тому канал не було зареєстровано. Команда openclaw doctor --fix видаляє застарілі символічні посилання залежностей середовища виконання Plugin і застарілі тіньові дані автентифікації, після чого openclaw gateway restart перезавантажує чистий стан.
Ознаки збоїв WhatsApp
| Симптом | Найшвидша перевірка | Виправлення |
|---|---|---|
| Підключено, але немає відповідей у приватних повідомленнях | openclaw pairing list whatsapp |
Схваліть відправника або змініть політику приватних повідомлень чи список дозволених. |
| Групові повідомлення ігноруються | Перевірте 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. |
Повний посібник з усунення несправностей: Усунення несправностей 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 від Plugin, 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?
