safeclaw-proxy para Openclaw

Una utilidad automatizada para instalar, configurar y verificar el proxy de seguridad SafeClaw para el enrutamiento seguro de modelos de agentes de IA.

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

Instalar y Descargar

1. ClawHub CLI

La forma más rápida de instalar una habilidad directamente desde el registro.

npx clawhub@latest install safeclaw-proxy

2. Instalación manual

Copia la carpeta de la habilidad a una de estas ubicaciones

Global
~/.openclaw/skills/
Espacio de trabajo
<project>/skills/

Prioridad: Espacio de trabajo > Local > Integrado

3. Instalación del prompt

Copia este prompt en OpenClaw para instalarlo automáticamente.

Ayúdame a instalar safeclaw-proxy usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).

¿Prefieres descargar?

Obtén los archivos originales de la habilidad en un archivo ZIP.

¿Qué es safeclaw-proxy?

Esta skill proporciona una configuración automatizada de extremo a extremo para el proxy de seguridad SafeClaw, un componente crítico para los desarrolladores que utilizan Openclaw Skills para monitorear y proteger el tráfico de LLM. Maneja la detección del entorno, la implementación en contenedores a través de Docker o Podman, y la reconfiguración automática del enrutamiento para varios modos de agente.

Al canalizar las llamadas a los modelos a través de un proxy local o alojado, los usuarios obtienen una visibilidad total de sus interacciones con IA a través de un panel dedicado, mientras se aplican barreras de seguridad. La skill gestiona de forma inteligente los parches de configuración para gateways, archivos de modelos de agente y entornos shell, asegurando que la seguridad se integre perfectamente en su flujo de trabajo de desarrollo profesional con Openclaw Skills.

Casos de uso de safeclaw-proxy

  • Configuración de un proxy de seguridad local para la monitorización y auditoría del tráfico de LLM.
  • Enrutamiento del tráfico de modelos de Openclaw Skills a través de una instancia de SafeClaw alojada remotamente.
  • Depuración de por qué las llamadas a modelos específicos no aparecen en su panel de monitoreo.
  • Automatización de la instalación de requisitos previos como Python 3.12 y el gestor de paquetes uv.
  • Aplicación de bloqueos de seguridad en tiempo real sobre solicitudes de modelos de IA potencialmente dañinas.

Cómo funciona safeclaw-proxy

  1. Inspecciona el entorno actual para determinar si Openclaw Skills está enrutando el tráfico a través de la configuración del gateway, archivos de modelos de agente o variables shell.
  2. Realiza comprobaciones previas para verificar los permisos de red de localhost y las capacidades de ejecución con privilegios.
  3. Implementa el contenedor del proxy SafeClaw utilizando Docker o Podman, con un fallback automático a una instalación nativa de Python si es necesario.
  4. Configura la ruta de enrutamiento parcheando la configuración del proveedor o editando el archivo agents.json para apuntar al nuevo URL del proxy.
  5. Ejecuta una comprobación de estado y una llamada de prueba de activación de seguridad deliberada para verificar que el tráfico se está interceptando y registrando correctamente.

Configuración de safeclaw-proxy

Para iniciar la configuración dentro de su entorno Openclaw Skills, asegúrese de tener una sesión activa y los permisos necesarios para la gestión de contenedores.

Implementación en contenedores

La skill prefiere ejecutarse a través de Docker o Podman:

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

Fallback de instalación manual

Si los entornos de ejecución de contenedores no están disponibles, la skill intentará una instalación local:

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

Esquema de datos y taxonomía de safeclaw-proxy

La skill gestiona e interactúa con varias estructuras de datos para garantizar un enrutamiento adecuado dentro de Openclaw Skills:

Componente Ruta / Key Descripción
Configuración de Gateway models.providers.<provider>.baseUrl Redirige el proveedor al endpoint v1 del proxy local.
Metadatos del agente ~/.openclaw/agents/main/agent/models.json Actualiza configuraciones específicas de enrutamiento de agente.
Perfil Shell OPENAI_BASE_URL Configura la variable de entorno para procesos iniciados mediante CLI.
API de estado {PROXY_URL}/aep/api/state Recupera el estado actual del proxy y los datos de conteo de llamadas.

Funciones avanzadas de safeclaw-proxy

  • Lógica inteligente de fallback de puerto de host que alterna desde 8899 hasta 8895 para evitar conflictos de puerto.
  • Gestión automatizada de dependencias que maneja la instalación de Python 3.12 y uv en sistemas macOS y Linux.
  • Funciones de seguridad de configuración, incluyendo copias de seguridad automáticas de models.json antes de que ocurra cualquier modificación.
  • Compatibilidad con modos de proxy local y alojado para adaptarse a diversas arquitecturas de implementación de Openclaw Skills.
  • Pruebas de seguridad integradas que interpretan códigos de estado HTTP para confirmar la protección activa y el registro en el panel.

SKILL.md


Cargando

Habilidades relacionadas de Openclaw

METADATA

Github Stars: 0
forks: 0

Presentado*