​

Перевірки стану (CLI)

​

Швидкі перевірки

• openclaw status — локальний підсумок: доступність/режим gateway, підказка про оновлення, давність автентифікації підключених каналів, сесії та нещодавня активність.
• openclaw status --all — повна локальна діагностика (лише читання, кольоровий вивід, безпечно вставляти для налагодження).
• openclaw status --deep — звертається до запущеного gateway для живої перевірки стану (health з probe:true), включно з перевірками каналів для кожного облікового запису, якщо це підтримується.
• openclaw health — звертається до запущеного gateway за знімком його стану (лише WS; CLI не відкриває прямі сокети каналів).
• openclaw health --verbose — примусово запускає живу перевірку стану і виводить відомості про підключення gateway.
• openclaw health --json — машинозчитуваний вивід знімка стану.
• Надішліть /status як окреме повідомлення у WhatsApp/WebChat, щоб отримати відповідь зі станом без запуску агента.
• Журнали: виконайте tail для /tmp/openclaw/openclaw-*.log і відфільтруйте web-heartbeat, web-reconnect, web-auto-reply, web-inbound.

​

Глибока діагностика

• Облікові дані на диску: ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json (mtime має бути нещодавнім).
• Сховище сесій: ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json (шлях можна перевизначити в конфігурації). Кількість і нещодавні отримувачі відображаються через status.
• Повторне прив’язування: openclaw channels logout && openclaw channels login --verbose, коли в журналах з’являються коди стану 409–515 або loggedOut. (Примітка: після сполучення потік входу через QR автоматично перезапускається один раз для статусу 515.)

​

Конфігурація монітора стану

• gateway.channelHealthCheckMinutes: як часто gateway перевіряє стан каналів. Типове значення: 5. Установіть 0, щоб глобально вимкнути перезапуски монітора стану.
• gateway.channelStaleEventThresholdMinutes: як довго підключений канал може залишатися без подій, перш ніж монітор стану вважатиме його застарілим і перезапустить. Типове значення: 30. Зберігайте це значення більшим або рівним gateway.channelHealthCheckMinutes.
• gateway.channelMaxRestartsPerHour: ковзне обмеження на одну годину для перезапусків монітора стану на канал/обліковий запис. Типове значення: 10.
• channels.<provider>.healthMonitor.enabled: вимкнути перезапуски монітора стану для конкретного каналу, залишивши глобальний моніторинг увімкненим.
• channels.<provider>.accounts.<accountId>.healthMonitor.enabled: перевизначення для кількох облікових записів, яке має пріоритет над налаштуванням на рівні каналу.
• Ці перевизначення для окремих каналів застосовуються до вбудованих моніторів каналів, які наразі їх підтримують: Discord, Google Chat, iMessage, Microsoft Teams, Signal, Slack, Telegram і WhatsApp.

​

Якщо щось не працює

• logged out або статус 409–515 → виконайте повторне прив’язування через openclaw channels logout, потім openclaw channels login.
• Gateway недоступний → запустіть його: openclaw gateway --port 18789 (використовуйте --force, якщо порт зайнятий).
• Немає вхідних повідомлень → переконайтеся, що підключений телефон онлайн і відправника дозволено (channels.whatsapp.allowFrom); для групових чатів переконайтеся, що список дозволу + правила згадування налаштовано правильно (channels.whatsapp.groups, agents.list[].groupChat.mentionPatterns).

​

Окрема команда “health”

• --json: машинозчитуваний JSON-вивід
• --timeout <ms>: перевизначити типове значення тайм-ауту перевірки 10 с
• --verbose: примусово запустити живу перевірку і вивести відомості про підключення gateway
• --debug: псевдонім для --verbose