---
read_when:
    - Потрібно перевірити керовану оператором маршрутизацію через проксі перед розгортанням
    - Вам потрібно локально захопити транспортний трафік OpenClaw для налагодження
    - Ви хочете переглянути сеанси проксі налагодження, бінарні об’єкти або вбудовані пресети запитів
summary: Довідка CLI для `openclaw proxy`, включно з перевіркою проксі, керованого оператором, та інспектором захоплень локального налагоджувального проксі
title: Проксі
x-i18n:
    generated_at: "2026-05-01T05:23:58Z"
    model: gpt-5.5
    provider: openai
    source_hash: e0820de861bfe1ec14e0c1624d636d6474b5fedd317e3ba1baaa61f6530e06e9
    source_path: cli/proxy.md
    workflow: 16
---

# `openclaw proxy`

Перевіряйте керовану оператором маршрутизацію проксі або запускайте локальний явний проксі для налагодження
та інспектуйте захоплений трафік.

Використовуйте `validate`, щоб попередньо перевірити керований оператором прямий проксі перед увімкненням
маршрутизації проксі OpenClaw. Інші команди є інструментами налагодження для
дослідження на транспортному рівні: вони можуть запускати локальний проксі, виконувати дочірню команду
з увімкненим захопленням, перелічувати сеанси захоплення, запитувати поширені шаблони трафіку, читати
захоплені blob-об’єкти та очищати локальні дані захоплення.

## Команди

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

## Перевірка

`openclaw proxy validate` перевіряє ефективну URL-адресу керованого оператором проксі з
`--proxy-url`, конфігурації або `OPENCLAW_PROXY_URL`. Вона повідомляє про проблему конфігурації, коли
проксі не ввімкнено й не налаштовано; використовуйте `--proxy-url` для одноразової попередньої перевірки
перед зміною конфігурації. За замовчуванням вона перевіряє, що публічний пункт призначення успішно доступний
через проксі та що проксі не може досягти тимчасової loopback-приманки.
Користувацькі заборонені пункти призначення блокуються за замовчуванням: HTTP-відповіді та неоднозначні
транспортні збої вважаються невдачею, якщо ви не можете окремо перевірити специфічний для розгортання
сигнал відмови.

Параметри:

- `--json`: вивести машиночитний JSON.
- `--proxy-url <url>`: перевірити цю URL-адресу проксі замість конфігурації або змінної середовища.
- `--allowed-url <url>`: додати пункт призначення, який має успішно працювати через проксі. Повторіть, щоб перевірити кілька пунктів призначення.
- `--denied-url <url>`: додати пункт призначення, який має блокуватися проксі. Повторіть, щоб перевірити кілька пунктів призначення.
- `--timeout-ms <ms>`: тайм-аут для кожного запиту в мілісекундах.

Див. [Мережевий проксі](/uk/security/network-proxy) для рекомендацій щодо розгортання та
семантики відмови.

## Попередні набори запитів

`openclaw proxy query --preset <name>` приймає:

- `double-sends`
- `retry-storms`
- `cache-busting`
- `ws-duplicate-frames`
- `missing-ack`
- `error-bursts`

## Примітки

- `start` за замовчуванням використовує `127.0.0.1`, якщо `--host` не задано.
- `run` запускає локальний проксі для налагодження, а потім виконує команду після `--`.
- `validate` завершується з кодом 1, коли конфігурація проксі або перевірки пунктів призначення не проходять.
- Захоплення є локальними даними налагодження; використовуйте `openclaw proxy purge`, коли завершите.

## Пов’язане

- [Довідник CLI](/uk/cli)
- [Мережевий проксі](/uk/security/network-proxy)
- [Автентифікація довіреного проксі](/uk/gateway/trusted-proxy-auth)
