Skip to main content

​
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.
validate 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

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-sends
  • retry-storms
  • cache-busting
  • ws-duplicate-frames
  • missing-ack
  • error-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.

​
Relacionados