Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Використовуйте цю сторінку, коли канал підключається, але поведінка неправильна.
Драбина команд
Спочатку виконайте їх по черзі:
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
Ознаки збоїв 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. |
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 відправників. |
Discord
Ознаки збоїв Discord
| Симптом | Найшвидша перевірка | Виправлення |
|---|
| Бот онлайн, але немає відповідей у гільдії | openclaw channels status --probe | Дозвольте гільдію/канал і перевірте намір доступу до вмісту повідомлень. |
| Групові повідомлення ігноруються | Перевірте журнали щодо відкидань через вимогу згадки | Згадайте бота або встановіть для гільдії/каналу requireMention: false. |
| Є індикація набору/використання токенів, але немає повідомлення Discord | Журнал сеансу показує текст асистента з didSendViaMessagingTool: false | Модель відповіла приватно замість виклику інструмента повідомлень. Використовуйте модель із надійними викликами інструментів або встановіть messages.groupChat.visibleReplies: "automatic" для автоматичного надсилання. |
| Відсутні відповіді в особистих повідомленнях | openclaw pairing list discord | Схваліть прив’язування особистих повідомлень або змініть політику особистих повідомлень. |
Slack
Ознаки збоїв Slack
| Симптом | Найшвидша перевірка | Виправлення |
|---|
| Режим сокета підключено, але відповідей немає | openclaw channels status --probe | Перевірте токен застосунку + токен бота та потрібні області доступу; стежте за botTokenStatus / appTokenStatus = configured_unavailable у налаштуваннях на основі SecretRef. |
| Особисті повідомлення заблоковано | openclaw pairing list slack | Схваліть прив’язування або послабте політику особистих повідомлень. |
| Повідомлення каналу ігнорується | Перевірте groupPolicy і список дозволених каналів | Дозвольте канал або змініть політику на open. |
iMessage
Ознаки збоїв iMessage
| Симптом | Найшвидша перевірка | Виправлення |
|---|
imsg відсутній або не працює на не-macOS | openclaw channels status --probe --channel imessage | Запустіть OpenClaw на Mac із Messages або використайте SSH-обгортку для cliPath. |
| Можна надсилати, але не отримувати на macOS | Перевірте дозволи приватності macOS для автоматизації Messages | Повторно надайте дозволи TCC і перезапустіть процес каналу. |
| Відправника особистих повідомлень заблоковано | openclaw pairing list imessage | Схваліть прив’язування або оновіть список дозволених. |
Signal
Ознаки збоїв Signal
| Симптом | Найшвидша перевірка | Виправлення |
|---|
| Демон доступний, але бот мовчить | openclaw channels status --probe | Перевірте URL/обліковий запис демона signal-cli і режим отримання. |
| Особисте повідомлення заблоковано | openclaw pairing list 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 може блокувати повідомлення, ініційовані ботом, без нещодавньої взаємодії. |
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 | Виправте сховище секретів, крос-підписування та стан резервної копії за один прохід. |
Пов’язане
