---
read_when:
    - Діагностика підключення каналу або стану Gateway
    - Розуміння команд і параметрів CLI для перевірки працездатності
summary: Команди перевірки справності та моніторинг справності Gateway
title: Перевірки працездатності
x-i18n:
    generated_at: "2026-04-28T11:11:51Z"
    model: gpt-5.5
    provider: openai
    source_hash: f34b91ef5d54b0fac7c451e46e07d36520a7d08fb0dce0538c6158d0bc6982b8
    source_path: gateway/health.md
    workflow: 16
---

Короткий посібник для перевірки з’єднання каналу без здогадок.

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

- `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, щоб отримати відповідь зі статусом без виклику агента.
- Журнали: перегляньте хвіст `/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 записує операційні факти, якщо не встановлено `diagnostics.enabled: false`. Події пам’яті записують кількість байтів RSS/heap, тиск порога та тиск зростання. Попередження про живучість записують затримку циклу подій, використання циклу подій, співвідношення CPU-ядер і кількість активних/очікуваних/поставлених у чергу сесій, коли процес працює, але насичений. Події надмірно великих payload записують, що було відхилено, усічено або розбито на частини, а також розміри й ліміти, коли вони доступні. Вони не записують текст повідомлення, вміст вкладень, тіло webhook, сире тіло запиту або відповіді, токени, cookies чи секретні значення. Той самий Heartbeat запускає обмежений записувач стабільності, доступний через `openclaw gateway stability` або Gateway RPC `diagnostics.stability`. Фатальні завершення Gateway, тайм-аути вимкнення та збої запуску після перезапуску зберігають найновіший знімок записувача в `~/.openclaw/logs/stability/`, коли існують події; перегляньте найновіший збережений bundle за допомогою `openclaw gateway stability --bundle latest`.
- Для звітів про помилки запустіть `openclaw gateway diagnostics export` і прикріпіть згенерований zip. Export поєднує підсумок Markdown, найновіший bundle стабільності, очищені метадані журналів, очищені знімки статусу/стану Gateway і форму конфігурації. Його призначено для поширення: текст чату, тіла webhook, виводи інструментів, облікові дані, cookies, ідентифікатори облікових записів/повідомлень і секретні значення вилучаються або редагуються. Див. [Експорт діагностики](/uk/gateway/diagnostics).

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

- `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`); для групових чатів переконайтеся, що allowlist + правила згадування збігаються (`channels.whatsapp.groups`, `agents.list[].groupChat.mentionPatterns`).

## Спеціальна команда "health"

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

Параметри:

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

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

## Пов’язане

- [Runbook Gateway](/uk/gateway)
- [Експорт діагностики](/uk/gateway/diagnostics)
- [Усунення несправностей Gateway](/uk/gateway/troubleshooting)
