English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

CLI commands

프록시

openclaw proxy

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

OpenClaw 프록시 라우팅을 활성화하기 전에 validate를 사용해 운영자 관리형 포워드 프록시를 사전 점검합니다. 다른 명령은 전송 수준 조사를 위한 디버깅 도구입니다. 로컬 프록시를 시작하고, 캡처를 활성화한 상태로 자식 명령을 실행하고, 캡처 세션을 나열하고, 일반적인 트래픽 패턴을 쿼리하고, 캡처된 blob을 읽고, 로컬 캡처 데이터를 제거할 수 있습니다.

명령

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>] [--apns-reachable] [--apns-authority <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는 --proxy-url, 구성 또는 OPENCLAW_PROXY_URL에서 유효한 운영자 관리형 프록시 URL을 확인합니다. 프록시가 활성화 및 구성되지 않은 경우 구성 문제를 보고합니다. 구성을 변경하기 전에 일회성 사전 점검을 하려면 --proxy-url을 사용하세요. 기본적으로 공개 대상이 프록시를 통해 성공하는지, 프록시가 임시 루프백 카나리에 도달할 수 없는지 확인합니다. 사용자 지정 거부 대상은 실패 시 닫힘 방식입니다. 배포별 거부 신호를 별도로 확인할 수 없는 한 HTTP 응답과 모호한 전송 실패가 모두 실패로 처리됩니다. --apns-reachable을 추가하면 프록시를 통해 APNs HTTP/2 CONNECT 터널도 열고 샌드박스 APNs가 응답하는지 확인합니다. 이 프로브는 의도적으로 잘못된 공급자 토큰을 사용하므로 APNs 403 InvalidProviderToken 응답은 도달 가능성을 나타내는 성공 신호입니다.

옵션:

  • --json: 기계가 읽을 수 있는 JSON을 출력합니다.
  • --proxy-url <url>: 구성 또는 env 대신 이 프록시 URL을 검증합니다.
  • --allowed-url <url>: 프록시를 통해 성공할 것으로 예상되는 대상을 추가합니다. 여러 대상을 확인하려면 반복합니다.
  • --denied-url <url>: 프록시에서 차단될 것으로 예상되는 대상을 추가합니다. 여러 대상을 확인하려면 반복합니다.
  • --apns-reachable: 프록시를 통해 샌드박스 APNs HTTP/2에 도달할 수 있는지도 확인합니다.
  • --apns-authority <url>: --apns-reachable로 프로브할 APNs authority입니다. 기본값은 https://api.sandbox.push.apple.com이며, 프로덕션은 https://api.push.apple.com입니다.
  • --timeout-ms <ms>: 요청별 제한 시간(밀리초)입니다.

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

쿼리 프리셋

openclaw proxy query --preset <name>는 다음을 허용합니다.

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

참고

  • start는 --host가 설정되지 않은 한 기본값으로 127.0.0.1을 사용합니다.
  • run은 로컬 디버그 프록시를 시작한 다음 -- 뒤의 명령을 실행합니다.
  • 디버그 프록시의 직접 업스트림 전달은 진단을 위해 업스트림 소켓을 엽니다. OpenClaw 관리형 프록시 모드가 활성화된 경우 프록시 요청과 CONNECT 터널에 대한 직접 전달은 기본적으로 비활성화됩니다. 승인된 로컬 진단에만 OPENCLAW_DEBUG_PROXY_ALLOW_DIRECT_CONNECT_WITH_MANAGED_PROXY=1을 설정하세요.
  • validate는 프록시 구성 또는 대상 확인이 실패하면 코드 1로 종료합니다.
  • 캡처는 로컬 디버깅 데이터입니다. 완료되면 openclaw proxy purge를 사용하세요.

관련 항목