Proxy

기준일: 2026-07-26
공식 기준: Proxy

Proxy 문서는 OpenClaw 공식 문서(cli/proxy)를 한국어로 정리한 가이드입니다. CLI reference for openclaw proxy, including operator-managed proxy validation and the local debug proxy capture inspector 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

CLI reference for openclaw proxy, including operator-managed proxy validation and the local debug proxy capture inspector

한국어 가이드 범위: cli/proxy 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• Validate
• 옵션
• Debug proxy
• 관련 문서

상세 내용

openclaw proxy

Validate operator-managed proxy routing, or run the local explicit debug proxy and inspect captured traffic.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

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

Checks the effective operator-managed proxy URL from --proxy-url, config (proxy.proxyUrl), or OPENCLAW_PROXY_URL, in that precedence order. Reports a config problem if no proxy is enabled and configured; pass --proxy-url for a one-off preflight without touching config.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• one allowed check against https://example.com/ (override/add with --allowed-url, repeatable)
• one denied check against a temporary loopback canary (override with --denied-url, repeatable)

옵션

Exits with code 1 when proxy config or destination checks fail.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Flag	Effect
--json	print machine-readable JSON
--proxy-url <url>	validate this http:///https:// proxy URL instead of config or env
--proxy-ca-file <path>	trust this PEM CA file for TLS verification of an HTTPS proxy endpoint
--allowed-url <url>	destination expected to succeed through the proxy (repeatable)
--denied-url <url>	destination expected to be blocked by the proxy (repeatable)
--apns-reachable	also verify sandbox APNs HTTP/2 is reachable through the proxy
--apns-authority <url>	APNs authority to probe (default https://api.sandbox.push.apple.com; production is https://api.push.apple.com)
--timeout-ms <ms>	per-request timeout

Debug proxy

start launches a local capturing proxy and prints its URL, CA cert path, and capture DB path; stop with Ctrl+C. Defaults to binding 127.0.0.1 unless --host is set.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

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

관련 문서

주요 항목:

• CLI reference
• Network Proxy
• Trusted proxy auth

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/cli/proxy
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

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

관련 링크

• 공식 원문: cli/proxy
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.