---
read_when:
    - Діагностика підключення каналів або стану gateway
    - Розуміння команд CLI для перевірки стану та їх параметрів
summary: Команди перевірки стану та моніторинг стану gateway
title: Перевірки стану
x-i18n:
    generated_at: "2026-04-05T18:03:16Z"
    model: gpt-5.4
    provider: openai
    source_hash: b8824bca34c4d1139f043481c75f0a65d83e54008898c34cf69c6f98fd04e819
    source_path: gateway/health.md
    workflow: 15
---

# Перевірки стану (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"

`openclaw health` звертається до запущеного gateway за знімком його стану (CLI не відкриває прямі сокети
каналів). Типово вона може повертати свіжий кешований знімок gateway; після цього
gateway оновлює цей кеш у фоновому режимі. `openclaw health --verbose` натомість примусово
запускає живу перевірку. Команда повідомляє про вік підключених creds/auth, якщо доступно,
підсумки перевірок по каналах, підсумок сховища сесій і тривалість перевірки. Вона завершується
з ненульовим кодом, якщо gateway недоступний або перевірка не вдалася/перевищила час очікування.

Параметри:

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

Знімок стану включає: `ok` (boolean), `ts` (часова позначка), `durationMs` (час перевірки), стан для кожного каналу, доступність агентів і підсумок сховища сесій.
