--- read_when: - Транспорт каналу повідомляє про підключення, але надсилання відповідей завершується помилкою - Потрібні перевірки, специфічні для каналу, перш ніж заглиблюватися в документацію провайдера. summary: Швидке усунення несправностей на рівні каналів із сигнатурами збоїв і виправленнями для кожного каналу title: Усунення несправностей каналів x-i18n: generated_at: "2026-05-11T20:22:45Z" model: gpt-5.5 provider: openai source_hash: f9a314cd772e15c038008b78603f811caaa40a3be31e7268c8fb1eefbb000b32 source_path: channels/troubleshooting.md workflow: 16 --- Використовуйте цю сторінку, коли канал підключається, але поведінка неправильна. ## Драбина команд Спочатку виконайте їх по черзі: ```bash openclaw status openclaw gateway status openclaw logs --follow openclaw doctor openclaw channels status --probe ``` Справна базова лінія: - `Runtime: running` - `Connectivity probe: ok` - `Capability: read-only`, `write-capable`, або `admin-capable` - Перевірка каналу показує, що транспорт підключено і, де підтримується, `works` або `audit ok` ## WhatsApp ### Ознаки збоїв 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](/uk/channels/whatsapp#troubleshooting) ## Telegram ### Ознаки збоїв 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](/uk/channels/telegram#troubleshooting) ## Discord ### Ознаки збоїв Discord | Симптом | Найшвидша перевірка | Виправлення | | ----------------------------------------- | ---------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Бот онлайн, але немає відповідей у гільдії | `openclaw channels status --probe` | Дозвольте гільдію/канал і перевірте намір доступу до вмісту повідомлень. | | Групові повідомлення ігноруються | Перевірте журнали щодо відкидань через вимогу згадки | Згадайте бота або встановіть для гільдії/каналу `requireMention: false`. | | Є індикація набору/використання токенів, але немає повідомлення Discord | Журнал сеансу показує текст асистента з `didSendViaMessagingTool: false` | Модель відповіла приватно замість виклику інструмента повідомлень. Використовуйте модель із надійними викликами інструментів або встановіть `messages.groupChat.visibleReplies: "automatic"` для автоматичного надсилання. | | Відсутні відповіді в особистих повідомленнях | `openclaw pairing list discord` | Схваліть прив’язування особистих повідомлень або змініть політику особистих повідомлень. | Повне усунення несправностей: [Усунення несправностей Discord](/uk/channels/discord#troubleshooting) ## Slack ### Ознаки збоїв Slack | Симптом | Найшвидша перевірка | Виправлення | | -------------------------------------- | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | Режим сокета підключено, але відповідей немає | `openclaw channels status --probe` | Перевірте токен застосунку + токен бота та потрібні області доступу; стежте за `botTokenStatus` / `appTokenStatus = configured_unavailable` у налаштуваннях на основі SecretRef. | | Особисті повідомлення заблоковано | `openclaw pairing list slack` | Схваліть прив’язування або послабте політику особистих повідомлень. | | Повідомлення каналу ігнорується | Перевірте `groupPolicy` і список дозволених каналів | Дозвольте канал або змініть політику на `open`. | Повне усунення несправностей: [Усунення несправностей Slack](/uk/channels/slack#troubleshooting) ## iMessage ### Ознаки збоїв iMessage | Симптом | Найшвидша перевірка | Виправлення | | ------------------------------------ | ------------------------------------------------------- | --------------------------------------------------------------------- | | `imsg` відсутній або не працює на не-macOS | `openclaw channels status --probe --channel imessage` | Запустіть OpenClaw на Mac із Messages або використайте SSH-обгортку для `cliPath`. | | Можна надсилати, але не отримувати на macOS | Перевірте дозволи приватності macOS для автоматизації Messages | Повторно надайте дозволи TCC і перезапустіть процес каналу. | | Відправника особистих повідомлень заблоковано | `openclaw pairing list imessage` | Схваліть прив’язування або оновіть список дозволених. | Повне усунення несправностей: - [Усунення несправностей iMessage](/uk/channels/imessage#troubleshooting) ## Signal ### Ознаки збоїв Signal | Симптом | Найшвидша перевірка | Виправлення | | ------------------------------- | ------------------------------------------ | -------------------------------------------------------- | | Демон доступний, але бот мовчить | `openclaw channels status --probe` | Перевірте URL/обліковий запис демона `signal-cli` і режим отримання. | | Особисте повідомлення заблоковано | `openclaw pairing list signal` | Схваліть відправника або змініть політику особистих повідомлень. | | Відповіді в групі не спрацьовують | Перевірте список дозволених груп і шаблони згадок | Додайте відправника/групу або послабте обмеження. | Повне усунення несправностей: [Усунення несправностей Signal](/uk/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 platform до взаємодії | QQ може блокувати повідомлення, ініційовані ботом, без нещодавньої взаємодії. | Повне усунення несправностей: [Усунення несправностей QQ Bot](/uk/channels/qqbot#troubleshooting) ## 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](/uk/channels/matrix) ## Пов’язане - [Прив’язування](/uk/channels/pairing) - [Маршрутизація каналів](/uk/channels/channel-routing) - [Усунення несправностей Gateway](/uk/gateway/troubleshooting)