Configuration
Усунення несправностей каналів
Використовуйте цю сторінку, коли канал підключається, але поведінка неправильна.
Послідовність команд
Спочатку виконайте їх у такому порядку:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Справний базовий стан:
Runtime: runningConnectivity probe: okCapability: read-only,write-capable, абоadmin-capable- Перевірка каналу показує, що транспорт підключено, і, де підтримується,
worksабоaudit ok
Ознаки збоїв WhatsApp
| Симптом | Найшвидша перевірка | Виправлення |
|---|---|---|
| Підключено, але немає відповідей у DM | openclaw pairing list whatsapp |
Схваліть відправника або змініть політику DM/список дозволених. |
| Повідомлення в групі ігноруються | Перевірте requireMention + шаблони згадок у config |
Згадайте бота або послабте політику згадок для цієї групи. |
| Вхід через QR завершується тайм-аутом із 408 | Перевірте env Gateway HTTPS_PROXY / HTTP_PROXY |
Налаштуйте доступний proxy; використовуйте NO_PROXY лише для обходів. |
| Випадкові цикли відключення/повторного входу | openclaw channels status --probe + журнали |
Нещодавні перепідключення позначаються навіть за поточного підключення; стежте за журналами, перезапустіть Gateway, а потім повторно прив’яжіть, якщо нестабільність триває. |
| Відповіді надходять із затримкою в секунди/хвилини | openclaw doctor --fix |
Doctor зупиняє перевірені застарілі локальні клієнти TUI, коли вони погіршують цикл подій Gateway. |
Повне усунення несправностей: Усунення несправностей WhatsApp
Telegram
Ознаки збоїв Telegram
| Симптом | Найшвидша перевірка | Виправлення |
|---|---|---|
/start, але немає придатного потоку відповідей |
openclaw pairing list telegram |
Схваліть прив’язування або змініть політику DM. |
| Бот онлайн, але група мовчить | Перевірте вимогу згадки та режим приватності бота | Вимкніть режим приватності для видимості в групі або згадайте бота. |
| Помилки надсилання з мережевими помилками | Перегляньте журнали на збої викликів Telegram API | Виправте маршрутизацію DNS/IPv6/proxy до api.telegram.org. |
Під час запуску повідомляється getMe returned 401 |
Перевірте налаштоване джерело token | Скопіюйте повторно або згенеруйте заново token BotFather і оновіть botToken, tokenFile або TELEGRAM_BOT_TOKEN облікового запису за замовчуванням. |
| Polling зависає або перепідключається повільно | openclaw logs --follow для діагностики polling |
Оновіть; якщо перезапуски є хибними спрацюваннями, налаштуйте pollingStallThresholdMs. Постійні зависання все ще вказують на proxy/DNS/IPv6. |
setMyCommands відхилено під час запуску |
Перегляньте журнали на BOT_COMMANDS_TOO_MUCH |
Зменште кількість команд Telegram із Plugin/skill/користувацьких команд або вимкніть нативні меню. |
| Після оновлення список дозволених блокує вас | openclaw security audit і списки дозволених у config |
Запустіть openclaw doctor --fix або замініть @username на числові ID відправників. |
Повне усунення несправностей: Усунення несправностей Telegram
Discord
Ознаки збоїв Discord
| Симптом | Найшвидша перевірка | Виправлення |
|---|---|---|
| Бот онлайн, але немає відповідей у guild | openclaw channels status --probe |
Дозвольте guild/channel і перевірте intent вмісту повідомлень. |
| Повідомлення в групі ігноруються | Перевірте журнали на відкидання через шлюз згадок | Згадайте бота або встановіть для guild/channel requireMention: false. |
| Є індикація typing/використання token, але немає повідомлення Discord | Журнал сесії показує текст помічника з didSendViaMessagingTool: false |
Модель відповіла приватно замість виклику message tool. Використайте модель із надійними tool calls або встановіть messages.groupChat.visibleReplies: "automatic" для автоматичного допису. |
| Відповіді в DM відсутні | openclaw pairing list discord |
Схваліть прив’язування DM або змініть політику DM. |
Повне усунення несправностей: Усунення несправностей Discord
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. |
Повне усунення несправностей: Усунення несправностей Slack
iMessage і BlueBubbles
Ознаки збоїв iMessage і BlueBubbles
| Симптом | Найшвидша перевірка | Виправлення |
|---|---|---|
| Немає вхідних подій | Перевірте досяжність Webhook/сервера та дозволи застосунку | Виправте URL Webhook або стан сервера BlueBubbles. |
| Можна надсилати, але немає отримання на macOS | Перевірте дозволи приватності macOS для автоматизації Messages | Повторно надайте дозволи TCC і перезапустіть процес каналу. |
| Відправника DM заблоковано | openclaw pairing list imessage або openclaw pairing list bluebubbles |
Схваліть прив’язування або оновіть список дозволених. |
Повне усунення несправностей:
Signal
Ознаки збоїв Signal
| Симптом | Найшвидша перевірка | Виправлення |
|---|---|---|
| Daemon доступний, але бот мовчить | openclaw channels status --probe |
Перевірте URL/account daemon signal-cli і режим отримання. |
| DM заблоковано | openclaw pairing list signal |
Схваліть відправника або змініть політику DM. |
| Відповіді в групі не запускаються | Перевірте список дозволених груп і шаблони згадок | Додайте відправника/групу або послабте шлюз. |
Повне усунення несправностей: Усунення несправностей Signal
QQ Bot
Ознаки збоїв QQ Bot
| Симптом | Найшвидша перевірка | Виправлення |
|---|---|---|
| Бот відповідає "gone to Mars" | Перевірте appId і clientSecret у config |
Налаштуйте облікові дані або перезапустіть Gateway. |
| Немає вхідних повідомлень | openclaw channels status --probe |
Перевірте облікові дані на QQ Open Platform. |
| Голос не транскрибується | Перевірте config постачальника STT | Налаштуйте channels.qqbot.stt або tools.media.audio. |
| Проактивні повідомлення не надходять | Перевірте вимоги взаємодії платформи QQ | QQ може блокувати ініційовані ботом повідомлення без нещодавньої взаємодії. |
Повне усунення несправностей: Усунення несправностей QQ Bot
Matrix
Ознаки збоїв Matrix
| Симптом | Найшвидша перевірка | Виправлення |
|---|---|---|
| Увійшов у систему, але ігнорує повідомлення кімнати | openclaw channels status --probe |
Перевірте groupPolicy, список дозволених кімнат і шлюз згадок. |
| DM не обробляються | openclaw pairing list matrix |
Схваліть відправника або змініть політику DM. |
| Зашифровані кімнати не працюють | openclaw matrix verify status |
Повторно перевірте пристрій, потім перевірте openclaw matrix verify backup status. |
| Відновлення backup очікує або пошкоджене | openclaw matrix verify backup status |
Запустіть openclaw matrix verify backup restore або повторіть із ключем відновлення. |
| Cross-signing/bootstrap виглядає неправильно | openclaw matrix verify bootstrap |
Виправте secret storage, cross-signing і стан backup за один прохід. |
Повне налаштування та config: Matrix