Конфигурация и эксплуатация

Проверки работоспособности

Краткое руководство по проверке подключения каналов без догадок.

Быстрые проверки

  • openclaw status — локальная сводка: доступность/режим шлюза, подсказка об обновлении, возраст авторизации привязанного канала, сессии + недавняя активность.
  • openclaw status --all — полная локальная диагностика (только чтение, цветной вывод, безопасно для вставки при отладке).
  • openclaw status --deep — также опрашивает запущенный шлюз (по-канальные проверки, если поддерживаются).
  • openclaw health --json — запрашивает у запущенного шлюза полный снимок состояния здоровья (только WS; без прямого сокета Baileys).
  • Отправьте /status как отдельное сообщение в WhatsApp/WebChat, чтобы получить ответ о статусе без вызова агента.
  • Логи: отслеживайте /tmp/openclaw/openclaw-*.log и фильтруйте по web-heartbeat, web-reconnect, web-auto-reply, web-inbound.

Углубленная диагностика

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

Если что-то не работает

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

Специальная команда "health"

openclaw health --json запрашивает у запущенного шлюза снимок его состояния (без прямых сокетов каналов из CLI). Она сообщает возраст привязанных учетных данных/авторизации, когда они доступны, сводки по-канальных проверок, сводку хранилища сессий и длительность проверки. Завершается с ненулевым кодом, если шлюз недоступен или проверка завершилась неудачей/таймаутом. Используйте --timeout <ms>, чтобы изменить значение по умолчанию (10 с).

Аутентификация доверенного проксиПульс (Heartbeat)