Configuration

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

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

Драбина команд

Спочатку виконайте їх по черзі:

bash

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probe

Справна базова лінія:

Runtime: running
Connectivity probe: ok
Capability: read-only, write-capable, або admin-capable
Перевірка каналу показує, що транспорт підключено і, де підтримується, works або audit ok

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

Симптом	Найшвидша перевірка	Виправлення
Підключено, але немає відповідей в особистих повідомленнях	`openclaw pairing list whatsapp`	Схваліть відправника або змініть політику/список дозволених для особистих повідомлень.
Групові повідомлення ігноруються	Перевірте `requireMention` + шаблони згадок у конфігурації	Згадайте бота або послабте політику згадок для цієї групи.
Вхід через QR завершується тайм-аутом із 408	Перевірте змінні середовища Gateway `HTTPS_PROXY` / `HTTP_PROXY`	Налаштуйте доступний проксі; використовуйте `NO_PROXY` лише для обходів.
Випадкові цикли відключення/повторного входу	`openclaw channels status --probe` + журнали	Нещодавні повторні підключення позначаються навіть тоді, коли зараз підключення активне; перегляньте журнали, перезапустіть Gateway, потім повторно прив’яжіть, якщо нестабільність триває.
Відповіді надходять із затримкою в секунди/хвилини	`openclaw doctor --fix`	Doctor зупиняє перевірені застарілі локальні клієнти TUI, коли вони погіршують роботу циклу подій Gateway.

Повне усунення несправностей: Усунення несправностей WhatsApp

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

Симптом	Найшвидша перевірка	Виправлення
`/start`, але немає придатного потоку відповідей	`openclaw pairing list telegram`	Схваліть прив’язування або змініть політику особистих повідомлень.
Бот онлайн, але група мовчить	Перевірте вимогу згадки та режим приватності бота	Вимкніть режим приватності для видимості в групі або згадайте бота.
Помилки надсилання через мережеві помилки	Перегляньте журнали щодо помилок викликів 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 для plugins/skills/користувацьких команд або вимкніть нативні меню.
Після оновлення список дозволених блокує вас	`openclaw security audit` і списки дозволених у конфігурації	Запустіть `openclaw doctor --fix` або замініть `@username` числовими ID відправників.

Повне усунення несправностей: Усунення несправностей Telegram

Discord

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

Симптом	Найшвидша перевірка	Виправлення
Бот онлайн, але немає відповідей у гільдії	`openclaw channels status --probe`	Дозвольте гільдію/канал і перевірте намір доступу до вмісту повідомлень.
Групові повідомлення ігноруються	Перевірте журнали щодо відкидань через вимогу згадки	Згадайте бота або встановіть для гільдії/каналу `requireMention: false`.
Є індикація набору/використання токенів, але немає повідомлення Discord	Журнал сеансу показує текст асистента з `didSendViaMessagingTool: false`	Модель відповіла приватно замість виклику інструмента повідомлень. Використовуйте модель із надійними викликами інструментів або встановіть `messages.groupChat.visibleReplies: "automatic"` для автоматичного надсилання.
Відсутні відповіді в особистих повідомленнях	`openclaw pairing list discord`	Схваліть прив’язування особистих повідомлень або змініть політику особистих повідомлень.

Повне усунення несправностей: Усунення несправностей Discord

Slack

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

Симптом	Найшвидша перевірка	Виправлення
Режим сокета підключено, але відповідей немає	`openclaw channels status --probe`	Перевірте токен застосунку + токен бота та потрібні області доступу; стежте за `botTokenStatus` / `appTokenStatus = configured_unavailable` у налаштуваннях на основі SecretRef.
Особисті повідомлення заблоковано	`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

Симптом	Найшвидша перевірка	Виправлення
Бот відповідає "gone to Mars"	Перевірте `appId` і `clientSecret` у конфігурації	Налаштуйте облікові дані або перезапустіть Gateway.
Немає вхідних повідомлень	`openclaw channels status --probe`	Перевірте облікові дані на QQ Open Platform.
Голос не транскрибується	Перевірте конфігурацію постачальника STT	Налаштуйте `channels.qqbot.stt` або `tools.media.audio`.
Проактивні повідомлення не надходять	Перевірте вимоги QQ platform до взаємодії	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?