safeclaw-proxy para Openclaw

Um utilitário automatizado para instalar, configurar e verificar o proxy de segurança SafeClaw para roteamento seguro de modelos de agentes de IA.

aceteam-ai
v1.0.0
Apr 17, 2026
0
640
0

Instalar e Baixar

1. ClawHub CLI

A maneira mais rápida de instalar uma habilidade diretamente do registro.

npx clawhub@latest install safeclaw-proxy

2. Instalação Manual

Copie a pasta da habilidade para um desses locais

Global
~/.openclaw/skills/
Espaço de trabalho
<project>/skills/

Prioridade: Espaço de Trabalho > Local > Integrado

3. Instalação do Prompt

Copie este prompt para o OpenClaw para instalá-lo automaticamente.

Ajude-me a instalar o safeclaw-proxy usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).

Prefere baixar?

Obtenha os arquivos originais da habilidade em um arquivo ZIP.

O que é safeclaw-proxy?

Esta skill fornece uma configuração automatizada de ponta a ponta para o proxy de segurança SafeClaw, um componente crítico para desenvolvedores que usam Openclaw Skills para monitorar e proteger o tráfego de LLM. Ele lida com detecção de ambiente, implantação conteinerizada via Docker ou Podman e reconfiguração automática de roteamento para vários modos de agente.

Ao direcionar as chamadas de modelo através de um proxy local ou hospedado, os usuários obtêm visibilidade total de suas interações de IA por meio de um painel dedicado, enquanto aplicam barreiras de segurança. A skill gerencia de forma inteligente patches de configuração para gateways, arquivos de modelo de agente e ambientes shell, garantindo que a segurança seja integrada perfeitamente ao seu fluxo de trabalho de desenvolvimento profissional com Openclaw Skills.

Casos de uso do safeclaw-proxy

  • Configuração de um proxy de segurança local para monitoramento e auditoria de tráfego de LLM.
  • Roteamento de tráfego de modelos Openclaw Skills através de uma instância SafeClaw hospedada remotamente.
  • Depuração do motivo pelo qual chamadas de modelo específicas não aparecem no seu painel de monitoramento.
  • Automação da instalação de pré-requisitos como Python 3.12 e o gerenciador de pacotes uv.
  • Aplicação de bloqueios de segurança em tempo real em solicitações de modelo de IA potencialmente prejudiciais.

Como o safeclaw-proxy funciona

  1. Inspeciona o ambiente atual para determinar se o Openclaw Skills está roteando o tráfego via configuração de gateway, arquivos de modelo de agente ou variáveis shell.
  2. Realiza verificações de pré-voo para verificar permissões de rede localhost e capacidades de execução elevada.
  3. Implanta o contêiner do proxy SafeClaw usando Docker ou Podman, com um fallback automático para uma instalação nativa do Python, se necessário.
  4. Configura o caminho de roteamento corrigindo as configurações do provedor ou editando o arquivo agents.json para apontar para o novo URL do proxy.
  5. Executa uma verificação de saúde e uma chamada de teste de gatilho de segurança deliberada para verificar se o tráfego está sendo interceptado e registrado corretamente.

Configuração do safeclaw-proxy

Para iniciar a configuração dentro do seu ambiente Openclaw Skills, certifique-se de ter uma sessão ativa e as permissões necessárias para o gerenciamento de contêineres.

Implantação Conteinerizada

A skill prefere ser executada via Docker ou Podman:

docker run -d --name safeclaw-proxy -p 8899:8899 ghcr.io/aceteam-ai/aep-proxy:latest

Fallback de Instalação Manual

Se os runtimes de contêiner não estiverem disponíveis, a skill tentará uma instalação local:

uv pip install aceteam-aep[all]
aceteam-aep proxy --port 8899 > /dev/null 2>&1 &

Esquema de Dados e Taxonomia de safeclaw-proxy

A skill gerencia e interage com várias estruturas de dados para garantir o roteamento adequado dentro do Openclaw Skills:

Componente Caminho / Key Descrição
Configuração de Gateway models.providers.<provider>.baseUrl Redireciona o provedor para o endpoint v1 do proxy local.
Metadados do Agente ~/.openclaw/agents/main/agent/models.json Atualiza configurações específicas de roteamento de agente.
Perfil Shell OPENAI_BASE_URL Configura a variável de ambiente para processos iniciados via CLI.
API de Estado {PROXY_URL}/aep/api/state Recupera o estado atual do proxy e dados de contagem de chamadas.

Recursos avançados do safeclaw-proxy

  • Lógica inteligente de fallback de porta de host que cicla de 8899 para 8895 para evitar conflitos de porta.
  • Gerenciamento automatizado de dependências que lida com a instalação do Python 3.12 e uv em sistemas macOS e Linux.
  • Recursos de segurança de configuração, incluindo backups automáticos de models.json antes que qualquer modificação ocorra.
  • Suporte para modos de proxy local e hospedado para acomodar várias arquiteturas de implantação de Openclaw Skills.
  • Testes de segurança integrados que interpretam códigos de status HTTP para confirmar a proteção ativa e o registro no painel.

SKILL.md


Carregamento

Habilidades relacionadas do Openclaw

METADATA

Github Stars: 0
forks: 0

Apresentou*