Skip to main content

​
openclaw proxy

Проверьте маршрутизацию через прокси, управляемый оператором, или запустите локальный явный отладочный прокси и изучите перехваченный трафик.
validate выполняет предварительную проверку прокси пересылки, управляемого оператором. Остальные команды — это инструменты отладки для исследования на транспортном уровне: запуск локального прокси с перехватом, выполнение дочерней команды через него, просмотр сеансов перехвата, анализ шаблонов трафика, чтение перехваченных бинарных объектов и удаление локальных данных перехвата.

​
Проверка

Проверяет фактически используемый URL прокси, управляемого оператором, из --proxy-url, конфигурации (proxy.proxyUrl) или OPENCLAW_PROXY_URL — в указанном порядке приоритета. Если прокси не включён и не настроен, сообщает о проблеме конфигурации; передайте --proxy-url, чтобы выполнить разовую предварительную проверку без изменения конфигурации. В URL управляемого прокси используется http:// для обычного прослушивателя прокси пересылки или https://, если OpenClaw должен сначала установить TLS-соединение с самой конечной точкой прокси, а затем отправлять прокси-запросы. Используйте --proxy-ca-file, чтобы доверять частному центру сертификации для этого TLS-соединения. По умолчанию выполняются:
  • одна проверка разрешённого подключения к https://example.com/ (переопределите или добавьте цели с помощью --allowed-url; допускается многократное указание)
  • одна проверка запрещённого подключения к временному контрольному адресу обратной петли (переопределите с помощью --denied-url; допускается многократное указание)
Для пользовательских целей --denied-url действует принцип запрета при сбое: как HTTP-ответы, так и неоднозначные транспортные ошибки считаются сбоями, если невозможно независимо подтвердить специфический для развёртывания сигнал запрета. Встроенный контрольный адрес обратной петли — единственная цель, для которой транспортная ошибка считается подтверждением блокировки. Добавьте --apns-reachable, чтобы также открыть через прокси туннель APNs HTTP/2 CONNECT и подтвердить ответ тестовой среды APNs. Проверка отправляет заведомо недействительный токен поставщика, поэтому ответ APNs 403 InvalidProviderToken считается успешным подтверждением доступности, а не сбоем.

​
Параметры

Завершается с кодом 1, если проверка конфигурации прокси или адресов назначения завершилась сбоем. Рекомендации по развёртыванию и семантике запрета см. в разделе Сетевой прокси.

​
Отладочный прокси

start запускает локальный прокси с перехватом и выводит его URL, путь к сертификату центра сертификации и путь к базе данных перехвата; для остановки нажмите Ctrl+C. По умолчанию привязывается к 127.0.0.1, если не задано --host. run запускает локальный отладочный прокси, а затем выполняет <cmd...> (после --) с применёнными переменными окружения прокси в отдельном сеансе перехвата. Прямая передача отладочного прокси на вышестоящие узлы открывает сокеты к ним для диагностики. Когда активен режим управляемого прокси OpenClaw, прямая передача прокси-запросов и туннелей CONNECT по умолчанию отключена; задавайте OPENCLAW_DEBUG_PROXY_ALLOW_DIRECT_CONNECT_WITH_MANAGED_PROXY=1 только для одобренной локальной диагностики. coverage выводит отчёт JSON (summary и entries для каждого транспорта) о том, какие транспорты перехватываются, работают только через прокси или не охвачены. sessions выводит список последних сеансов перехвата (--limit, по умолчанию 20). query --preset <name> выполняет встроенный запрос к перехваченному трафику, при необходимости ограничивая его область значением --session <id>. Предустановки:
  • double-sends
  • retry-storms
  • cache-busting
  • ws-duplicate-frames
  • missing-ack
  • error-bursts
blob --id <blobId> выводит необработанное содержимое перехваченного бинарного объекта с полезной нагрузкой. purge удаляет все метаданные и бинарные объекты перехваченного трафика. Перехваченные данные предназначены для локальной отладки; удалите их после завершения работы.

​
Связанные материалы