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
| Симптом | Найшвидша перевірка | Виправлення |
|---|---|---|
| Підключено, але немає відповідей у 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. |
Повне усунення несправностей: Усунення несправностей WhatsApp
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 відправників. |
Повне усунення несправностей: Усунення несправностей Telegram
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. |
Повне усунення несправностей: Усунення несправностей 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
Сигнатури збоїв 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. |
| Відповіді групи не запускаються | Перевірте список дозволених груп і шаблони згадок | Додайте відправника/групу або послабте обмеження. |
Повне усунення несправностей: Усунення несправностей Signal
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 може блокувати повідомлення, ініційовані ботом, без нещодавньої взаємодії. |
Повне усунення несправностей: Усунення несправностей QQ Bot
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 і стан резервної копії за один прохід. |
Повне налаштування й конфігурація: Matrix
Пов’язане
Was this useful?
