openclaw proxy

운영자가 관리하는 프록시 라우팅을 검증하거나, 로컬 명시적 디버그 프록시를 실행하고 캡처된 트래픽을 검사합니다.

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 coverageopenclaw proxy sessions [--limit <count>]openclaw proxy query --preset <name> [--session <id>]openclaw proxy blob --id <blobId>openclaw proxy purge

validate는 운영자가 관리하는 정방향 프록시를 사전 점검합니다. 나머지는 전송 계층 조사를 위한 디버깅 도구입니다. 로컬 캡처 프록시를 시작하고, 이를 통해 하위 명령을 실행하고, 캡처 세션을 나열하고, 트래픽 패턴을 조회하고, 캡처된 블롭을 읽고, 로컬 캡처 데이터를 삭제할 수 있습니다.

검증

--proxy-url, 설정(proxy.proxyUrl), OPENCLAW_PROXY_URL 순의 우선순위로 유효한 운영자 관리 프록시 URL을 확인합니다. 활성화되고 구성된 프록시가 없으면 설정 문제를 보고합니다. 설정을 변경하지 않고 일회성 사전 점검을 수행하려면 --proxy-url을 전달하세요.

관리형 프록시 URL은 일반 정방향 프록시 리스너에 http://를 사용하며, OpenClaw가 프록시 요청을 보내기 전에 프록시 엔드포인트 자체에 TLS 연결을 열어야 하는 경우 https://를 사용합니다. 해당 TLS 연결에서 사설 CA를 신뢰하려면 --proxy-ca-file을 사용하세요.

기본적으로 다음을 실행합니다.

• https://example.com/에 대한 허용됨 검사 1회(--allowed-url로 재정의하거나 추가 가능, 반복 지정 가능)
• 임시 루프백 카나리아에 대한 거부됨 검사 1회(--denied-url로 재정의 가능, 반복 지정 가능)

사용자 지정 --denied-url 대상은 실패 시 차단 방식으로 동작합니다. 배포별 거부 신호를 독립적으로 확인할 수 없는 한, HTTP 응답과 모호한 전송 실패 모두 검사 실패로 간주합니다. 전송 오류를 차단 증거로 처리하는 대상은 기본 제공 루프백 카나리아뿐입니다.

프록시를 통해 APNs HTTP/2 CONNECT 터널도 열고 샌드박스 APNs의 응답을 확인하려면 --apns-reachable을 추가하세요. 이 검사는 의도적으로 유효하지 않은 제공자 토큰을 전송하므로, APNs의 403 InvalidProviderToken 응답은 실패가 아니라 도달 가능함을 나타내는 성공 신호로 간주됩니다.

옵션

프록시 설정 또는 대상 검사가 실패하면 종료 코드 1로 종료합니다.

배포 지침과 거부 의미 체계는 네트워크 프록시를 참조하세요.

디버그 프록시

start는 로컬 캡처 프록시를 시작하고 해당 URL, CA 인증서 경로, 캡처 DB 경로를 출력합니다. Ctrl+C로 중지하세요. --host를 설정하지 않으면 기본적으로 127.0.0.1에 바인딩합니다.

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 참조
• 네트워크 프록시
• 신뢰할 수 있는 프록시 인증