> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Проверки работоспособности Краткое руководство по проверке подключения каналов без догадок. ## Быстрые проверки * `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, идентификаторы учётных записей/сообщений и секретные значения исключаются или редактируются. См. [Экспорт диагностики](https://docs2.openclaw.ai/ru/gateway/diagnostics.md). ## Конфигурация монитора работоспособности * `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](https://docs2.openclaw.ai/ru/gateway.md) * [Экспорт диагностики](https://docs2.openclaw.ai/ru/gateway/diagnostics.md) * [Устранение неполадок Gateway](https://docs2.openclaw.ai/ru/gateway/troubleshooting.md)