# openclaw proxy

Convalida l'instradamento proxy gestito dall'operatore oppure esegue il proxy di debug esplicito locale e ispeziona il traffico acquisito.

Usa validate per eseguire il preflight di un proxy di inoltro gestito dall'operatore prima di abilitare l'instradamento proxy di OpenClaw. Gli altri comandi sono strumenti di debug per indagini a livello di trasporto: possono avviare un proxy locale, eseguire un comando figlio con l'acquisizione abilitata, elencare le sessioni di acquisizione, interrogare pattern di traffico comuni, leggere blob acquisiti ed eliminare i dati di acquisizione locali.

# Comandi

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

# Convalida

openclaw proxy validate controlla l'URL proxy effettivo gestito dall'operatore da --proxy-url, dalla configurazione o da OPENCLAW_PROXY_URL. Segnala un problema di configurazione quando nessun proxy è abilitato e configurato; usa --proxy-url per un preflight una tantum prima di modificare la configurazione. Per impostazione predefinita verifica che una destinazione pubblica abbia esito positivo attraverso il proxy e che il proxy non possa raggiungere un canary di loopback temporaneo. Le destinazioni negate personalizzate sono fail-closed: le risposte HTTP e gli errori di trasporto ambigui falliscono entrambi, a meno che tu possa verificare separatamente un segnale di negazione specifico della distribuzione. Aggiungi --apns-reachable per aprire anche un tunnel CONNECT HTTP/2 APNs attraverso il proxy e confermare che APNs sandbox risponda; il probe usa un token provider intenzionalmente non valido, quindi una risposta APNs 403 InvalidProviderToken è un segnale di raggiungibilità riuscito.

Opzioni:

• --json: stampa JSON leggibile da macchina.
• --proxy-url <url>: convalida questo URL proxy invece della configurazione o dell'ambiente.
• --allowed-url <url>: aggiunge una destinazione che dovrebbe riuscire attraverso il proxy. Ripeti per controllare più destinazioni.
• --denied-url <url>: aggiunge una destinazione che dovrebbe essere bloccata dal proxy. Ripeti per controllare più destinazioni.
• --apns-reachable: verifica anche che APNs sandbox HTTP/2 sia raggiungibile attraverso il proxy.
• --apns-authority <url>: autorità APNs da sondare con --apns-reachable (https://api.sandbox.push.apple.com per impostazione predefinita; la produzione è https://api.push.apple.com).
• --timeout-ms <ms>: timeout per richiesta in millisecondi.

Consulta Proxy di rete per indicazioni sulla distribuzione e semantica di negazione.

# Preset di query

openclaw proxy query --preset <name> accetta:

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

# Note

• start usa 127.0.0.1 per impostazione predefinita, a meno che --host sia impostato.
• run avvia un proxy di debug locale e poi esegue il comando dopo --.
• L'inoltro upstream diretto del proxy di debug apre socket upstream per la diagnostica. Quando la modalità proxy gestita di OpenClaw è attiva, l'inoltro diretto per le richieste proxy e i tunnel CONNECT è disabilitato per impostazione predefinita; imposta OPENCLAW_DEBUG_PROXY_ALLOW_DIRECT_CONNECT_WITH_MANAGED_PROXY=1 solo per diagnostica locale approvata.
• validate esce con codice 1 quando la configurazione proxy o i controlli delle destinazioni falliscono.
• Le acquisizioni sono dati di debug locali; usa openclaw proxy purge quando hai finito.

# Correlati

• Riferimento CLI
• Proxy di rete
• Autenticazione proxy attendibile