CLI commands
Proxy
openclaw proxy
Valide o roteamento de proxy gerenciado pelo operador ou execute o proxy de depuração explícito local e inspecione o tráfego capturado.
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 purgevalidate faz uma verificação preliminar de um proxy de encaminhamento gerenciado pelo operador. Os demais são ferramentas de depuração para investigação no nível de transporte: iniciar um proxy local com captura, executar um comando filho por meio dele, listar sessões de captura, consultar padrões de tráfego, ler blobs capturados e excluir os dados de captura locais.
Validação
Verifica a URL efetiva do proxy gerenciado pelo operador, obtida de --proxy-url, da configuração (proxy.proxyUrl) ou de OPENCLAW_PROXY_URL, nessa ordem de precedência. Relata um problema de configuração se nenhum proxy estiver habilitado e configurado; passe --proxy-url para uma verificação preliminar pontual sem alterar a configuração.
As URLs de proxy gerenciado usam http:// para um listener de proxy de encaminhamento sem criptografia ou https:// quando o OpenClaw precisa abrir uma conexão TLS com o próprio endpoint do proxy antes de enviar solicitações de proxy. Use --proxy-ca-file para confiar em uma CA privada nessa conexão TLS.
Por padrão, ele executa:
- uma verificação permitida em
https://example.com/(substitua ou adicione com--allowed-url, que pode ser repetida) - uma verificação negada em um canário temporário de local loopback (substitua com
--denied-url, que pode ser repetida)
Os destinos personalizados de --denied-url adotam falha segura: tanto respostas HTTP quanto falhas de transporte ambíguas contam como falhas, a menos que você possa verificar de forma independente um sinal de negação específico da implantação. O canário integrado de local loopback é o único destino em que um erro de transporte é tratado como prova de bloqueio.
Adicione --apns-reachable para também abrir um túnel CONNECT HTTP/2 do APNs por meio do proxy e confirmar que o APNs do ambiente sandbox responde. A sondagem envia intencionalmente um token de provedor inválido; portanto, uma resposta 403 InvalidProviderToken do APNs conta como um sinal bem-sucedido de acessibilidade, não como falha.
Opções
| Sinalizador | Efeito |
|---|---|
--json |
imprime JSON legível por máquina |
--proxy-url <url> |
valida esta URL de proxy http:///https:// em vez da configuração ou variável de ambiente |
--proxy-ca-file <path> |
confia neste arquivo de CA PEM para verificar por TLS um endpoint de proxy HTTPS |
--allowed-url <url> |
destino que deve ser acessado com sucesso por meio do proxy (pode ser repetida) |
--denied-url <url> |
destino que deve ser bloqueado pelo proxy (pode ser repetida) |
--apns-reachable |
também verifica se o HTTP/2 do APNs do ambiente sandbox está acessível por meio do proxy |
--apns-authority <url> |
autoridade do APNs a sondar (padrão: https://api.sandbox.push.apple.com; produção: https://api.push.apple.com) |
--timeout-ms <ms> |
tempo limite por solicitação |
Encerra com o código 1 quando a configuração do proxy ou as verificações de destino falham.
Consulte Proxy de rede para obter orientações de implantação e informações sobre a semântica de negação.
Proxy de depuração
start inicia um proxy local com captura e imprime sua URL, o caminho do certificado da CA e o caminho do banco de dados de capturas; interrompa-o com Ctrl+C. Por padrão, vincula-se a 127.0.0.1, a menos que --host seja definido.
run inicia um proxy de depuração local e, em seguida, executa <cmd...> (após --) com as variáveis de ambiente do proxy aplicadas, em sua própria sessão de captura.
O encaminhamento direto para upstream do proxy de depuração abre sockets upstream para diagnóstico. Quando o modo de proxy gerenciado do OpenClaw está ativo, o encaminhamento direto de solicitações de proxy e túneis CONNECT fica desabilitado por padrão; defina OPENCLAW_DEBUG_PROXY_ALLOW_DIRECT_CONNECT_WITH_MANAGED_PROXY=1 somente para diagnósticos locais aprovados.
coverage imprime um relatório JSON (summary + entries por transporte) indicando quais transportes são capturados, funcionam apenas por proxy ou não têm cobertura.
sessions lista sessões de captura recentes (--limit, padrão: 20).
query --preset <name> executa uma consulta integrada no tráfego capturado, opcionalmente limitada a --session <id>. Predefinições:
double-sendsretry-stormscache-bustingws-duplicate-framesmissing-ackerror-bursts
blob --id <blobId> imprime o conteúdo bruto de um blob de payload capturado.
purge exclui todos os metadados e blobs de tráfego capturado. As capturas são dados locais de depuração; exclua-as ao terminar.
