--- read_when: - Диагностика подключения каналов или состояния Gateway - Общие сведения о командах и параметрах CLI для проверки работоспособности summary: Команды проверки работоспособности и мониторинг состояния Gateway title: Проверки работоспособности x-i18n: generated_at: "2026-07-13T19:48:07Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 24 provider: openai source_hash: 6cc015fcd8dc002eafac95fb3e7aa0b6f3be5b9995e94438e2fed539a561931d source_path: gateway/health.md workflow: 16 --- Краткое руководство по проверке подключения каналов без догадок. ## Быстрые проверки - `openclaw status` — локальная сводка: доступность/режим Gateway, подсказка об обновлении, возраст авторизации подключённого канала, сеансы и недавняя активность. - `openclaw status --all` — полная локальная диагностика (только чтение, цветной вывод, можно безопасно вставлять при отладке). - `openclaw status --deep` — запрашивает у работающего Gateway оперативную проверку (`health` с `probe:true`), включая проверки каналов для отдельных учётных записей, если они поддерживаются. - `openclaw status --usage` — показывает снимки использования и квот поставщиков моделей. - `openclaw health` — запрашивает у работающего Gateway снимок состояния работоспособности (только через WS; CLI не открывает прямые сокеты каналов). - `openclaw health --verbose` (псевдоним `--debug`) — принудительно выполняет оперативную проверку работоспособности и выводит сведения о подключении к Gateway. - `openclaw health --json` — выводит машиночитаемый снимок состояния работоспособности. - Отправьте `/status` как отдельную команду чата в любом канале, чтобы получить ответ о состоянии без вызова агента. - Журналы: отслеживайте `/tmp/openclaw/openclaw-*.log` и фильтруйте по `web-heartbeat`, `web-reconnect`, `web-auto-reply`, `web-inbound`. Для Discord и других поставщиков чатов строки сеансов не отражают активность сокета. `openclaw sessions`, Gateway `sessions.list` и инструмент агента `sessions_list` читают сохранённое состояние беседы. Поставщик может переподключиться и показать работоспособное состояние канала до появления новой строки сеанса. Для оперативной проверки подключения используйте приведённые выше команды состояния канала и работоспособности. ## Углублённая диагностика - Учётные данные на диске: `ls -l ~/.openclaw/credentials/whatsapp//creds.json` (время изменения должно быть недавним). - Хранилище сеансов: `ls -l ~/.openclaw/agents//agent/openclaw-agent.sqlite`. Количество и недавние получатели отображаются через `status`. - Повторное подключение: используйте `openclaw channels logout && openclaw channels login --verbose`, когда в журналах появляются коды состояния 409-515 или `loggedOut`. После сопряжения процесс входа по QR-коду автоматически перезапускается один раз при коде состояния 515. - Диагностика включена по умолчанию (`diagnostics.enabled: false` отключает её). События памяти записывают объёмы RSS/кучи в байтах, а также нагрузку из-за превышения порогов или роста; критическая нехватка памяти регистрируется через журнал Gateway и, если задано `diagnostics.memoryPressureSnapshot: true`, также приводит к записи пакета данных о стабильности перед OOM (статистика кучи V8, счётчики Linux cgroup при наличии, количество активных ресурсов, крупнейшие файлы сеансов/транскриптов с отредактированными относительными путями). Предупреждения о работоспособности записывают задержку/утилизацию цикла событий, соотношение использования ядер ЦП и количество активных/ожидающих/поставленных в очередь сеансов, когда процесс работает, но перегружен. События превышения размера полезной нагрузки записывают, что было отклонено/усечено/разбито на части, а также размеры и ограничения, но никогда не записывают текст сообщений, содержимое вложений, тела Webhook, необработанные тела запросов/ответов, токены, файлы cookie или секретные значения. - Тот же Heartbeat управляет ограниченным регистратором стабильности: `openclaw gateway stability` (или RPC Gateway `diagnostics.stability`). При фатальном завершении Gateway, истечении времени ожидания завершения работы, сбое запуска после перезапуска и (если задано `diagnostics.memoryPressureSnapshot: true`) критической нехватке памяти последний снимок сохраняется в `~/.openclaw/logs/stability/`. Просмотрите новейший пакет с помощью `openclaw gateway stability --bundle latest`. - Для отчётов об ошибках выполните `openclaw gateway diagnostics export` и приложите созданный ZIP-архив: сводку Markdown, новейший пакет данных о стабильности, очищенные метаданные журналов, очищенные снимки состояния/работоспособности Gateway и структуру конфигурации. Текст чатов, тела Webhook, вывод инструментов, учётные данные, файлы cookie, идентификаторы учётных записей/сообщений и секретные значения исключаются или редактируются. См. [Экспорт диагностики](/ru/gateway/diagnostics). ## Конфигурация монитора работоспособности - `gateway.channelHealthCheckMinutes`: частота, с которой Gateway проверяет работоспособность каналов. По умолчанию: `5`. Установите `0`, чтобы глобально отключить перезапуски монитором работоспособности. - `gateway.channelStaleEventThresholdMinutes`: время, в течение которого подключённый канал может оставаться неактивным, прежде чем монитор работоспособности сочтёт его устаревшим и перезапустит. По умолчанию: `30`. Это значение должно быть больше или равно `gateway.channelHealthCheckMinutes`. - `gateway.channelMaxRestartsPerHour`: скользящее ограничение на количество перезапусков монитором работоспособности для каждого канала/учётной записи за один час. По умолчанию: `10`. - `channels..healthMonitor.enabled`: отключает перезапуски монитором работоспособности для конкретного канала, оставляя глобальный мониторинг включённым. - `channels..accounts..healthMonitor.enabled`: переопределение для нескольких учётных записей, имеющее приоритет над настройкой уровня канала. - Эти переопределения для отдельных каналов применяются к встроенным каналам, которые сейчас их предоставляют: Discord, Google Chat, iMessage, IRC, Microsoft Teams, Signal, Slack, Telegram и WhatsApp. ## Мониторинг времени бесперебойной работы Внешние службы мониторинга времени бесперебойной работы должны использовать специальную конечную точку `/health`, а не `/v1/chat/completions`. - **ИСПОЛЬЗУЙТЕ:** `GET /health` — мгновенный ответ, сеанс не создаётся, LLM не вызывается, возвращается `{"ok":true,"status":"live"}` - **НЕ ИСПОЛЬЗУЙТЕ:** `/v1/chat/completions` для проверок работоспособности — каждый запрос создаёт полноценный сеанс агента со снимком навыков, сборкой контекста и вызовами LLM Если заголовок `x-openclaw-session-key` или поле `user` не переданы, `/v1/chat/completions` создаёт новый случайный сеанс для каждого запроса. Службы мониторинга, отправляющие запрос каждые 15 минут, создают ~96 сеансов/день, каждый из которых занимает 4-22KB. Со временем это раздувает хранилище сеансов и может привести к переполнению контекстного окна. ### Примеры настройки служб мониторинга - **BetterStack:** задайте URL проверки работоспособности: `https://:/health` - **UptimeRobot:** добавьте новый монитор HTTP с URL `https://:/health` - **Общий вариант:** любой HTTP GET-запрос к `/health` возвращает 200 с `{"ok":true}`, когда Gateway работоспособен ## При сбое - `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 обновляет этот кэш в фоновом режиме; `--verbose` вместо этого принудительно выполняет оперативную проверку. Команда сообщает возраст подключённых учётных данных/авторизации при наличии, сводки проверок для каждого канала, сводку хранилища сеансов и длительность проверки. Она завершается с ненулевым кодом, если Gateway недоступен либо проверка завершается с ошибкой или по тайм-ауту. Параметры: - `--json`: машиночитаемый вывод JSON - `--timeout `: переопределяет стандартный тайм-аут проверки 10s - `--verbose`: принудительно выполняет оперативную проверку и выводит сведения о подключении к Gateway - `--debug`: псевдоним для `--verbose` Снимок состояния работоспособности включает: `ok` (логическое значение), `ts` (временная метка), `durationMs` (время проверки), состояние каждого канала, доступность агента и сводку хранилища сеансов. ## Связанные материалы - [Руководство по эксплуатации Gateway](/ru/gateway) - [Экспорт диагностики](/ru/gateway/diagnostics) - [Устранение неполадок Gateway](/ru/gateway/troubleshooting)