---
read_when:
    - Перед развёртыванием необходимо проверить маршрутизацию через прокси-сервер, управляемую оператором
    - Вам нужно локально перехватить транспортный трафик OpenClaw для отладки
    - Вы хотите просмотреть сеансы отладочного прокси, большие двоичные объекты или встроенные шаблоны запросов
summary: Справочник по CLI для `openclaw proxy`, включая проверку прокси, управляемого оператором, и локальный инспектор перехвата трафика отладочного прокси
title: Прокси
x-i18n:
    generated_at: "2026-07-13T18:00:10Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 24
    provider: openai
    source_hash: 91583f785032bfffe455a1963804108550f6fbb735ac4de1dd91d0ca5ae0df35
    source_path: cli/proxy.md
    workflow: 16
---

# `openclaw proxy`

Проверьте маршрутизацию через прокси, управляемый оператором, или запустите локальный явный отладочный прокси и изучите перехваченный трафик.

```bash
openclaw proxy validate [--json] [--proxy-url <url>] [--proxy-ca-file <path>] [--allowed-url <url>] [--denied-url <url>] [--apns-reachable] [--apns-authority <url>] [--timeout-ms <ms>]
openclaw proxy start [--host <host>] [--port <port>]
openclaw proxy run [--host <host>] [--port <port>] -- <cmd...>
openclaw proxy coverage
openclaw proxy sessions [--limit <count>]
openclaw proxy query --preset <name> [--session <id>]
openclaw proxy blob --id <blobId>
openclaw proxy purge
```

`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` считается успешным подтверждением доступности, а не сбоем.

### Параметры

| Флаг                     | Действие                                                                                                             |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------ |
| `--json`                 | вывести машиночитаемый JSON                                                                                        |
| `--proxy-url <url>`      | проверить этот URL прокси `http://`/`https://` вместо конфигурации или переменной окружения                                              |
| `--proxy-ca-file <path>` | доверять этому PEM-файлу центра сертификации при TLS-проверке конечной точки HTTPS-прокси                                             |
| `--allowed-url <url>`    | адрес назначения, подключение к которому через прокси должно завершиться успешно (допускается многократное указание)                                                     |
| `--denied-url <url>`     | адрес назначения, который прокси должен блокировать (допускается многократное указание)                                                       |
| `--apns-reachable`       | также проверить доступность тестовой среды APNs HTTP/2 через прокси                                                     |
| `--apns-authority <url>` | центр сертификации APNs для проверки (по умолчанию `https://api.sandbox.push.apple.com`; рабочая среда — `https://api.push.apple.com`) |
| `--timeout-ms <ms>`      | время ожидания для каждого запроса                                                                                                |

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

Рекомендации по развёртыванию и семантике запрета см. в разделе [Сетевой прокси](/ru/security/network-proxy).

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

`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` удаляет все метаданные и бинарные объекты перехваченного трафика. Перехваченные данные предназначены для локальной отладки; удалите их после завершения работы.

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

- [Справочник CLI](/ru/cli)
- [Сетевой прокси](/ru/security/network-proxy)
- [Аутентификация доверенного прокси](/ru/gateway/trusted-proxy-auth)
