     ____         ____                       ____  _
    / __ \  ___  / __/___   ___   ___  ___  / ___|| | __ _ __      __
   / / / / / _ \/ /_// _ \ / _ \ / __|/ _ \| |    | |/ _` |\ \ /\ / /
  / /_/ / /  __/ __//  __/| | | |\__ \  __/| |___ | | (_| | \ V  V /
 /_____/  \___/_/   \___/ |_| |_||___/\___| \____||_|\__,_|  \_/\_/

DefenseClaw

Gobernanza de seguridad para OpenClaw y runtimes de IA agéntica.
Escanea capacidades antes de usarlas, inspecciona el tráfico en tiempo de ejecución y exporta evidencia de auditoría duradera.

DefenseClaw combina una CLI de operador en Python, un gateway en Go, hooks de conectores, políticas, escáneres y exportadores de observabilidad. Es una capa de aplicación y evidencia; no demuestra que un agente, una interacción con un modelo o una capacidad de terceros esté libre de riesgos.

Documentación

El sitio web de documentación de DefenseClaw es la fuente de referencia para la instalación, configuración, comandos y flujos de trabajo del operador:

Tema	Guía canónica
Instalación	Instalar DefenseClaw
Primera ejecución	Inicio rápido
Actualización	Actualización
Windows	Windows nativo
Conectores	Compatibilidad de conectores
Guardrails	Configuración de guardrails
Configuración	Referencia de configuración
CLI	Referencia de la CLI
Observabilidad	Observabilidad

El Markdown del repositorio se limita a guías para colaboradores, contratos de implementación, notas locales de paquetes, referencias de esquemas generados, fixtures de pruebas y registros históricos de diseño. Comienza en docs/README.md.

Desarrollo desde el código fuente

Los objetivos de código fuente son herramientas para colaboradores. No son una vía de instalación ni de actualización para un host gestionado por versiones; usa las guías del sitio web anteriores para esas tareas. Los contratos de toolchain registrados en el repositorio son Python >=3.10,<3.14 (pyproject.toml) y Go 1.26.4 (go.mod). La CI prueba los componentes de TypeScript con Node.js 24.

git clone https://github.com/cisco-ai-defense/defenseclaw.git
cd defenseclaw
make build
make test
make check
make lint

make build produce artefactos del checkout sin publicarlos ni modificar el estado de la instalación gestionada; su paso pycli puede crear o actualizar el .venv compartido local del repositorio. Ejecuta make help antes de usar objetivos de código fuente que cambian el estado. Todos los objetivos de código fuente locales comparten ese único .venv bloqueado y listo para pruebas; no hay un entorno de Python separado de producción frente a desarrollo que seleccionar. make test, make check y make py-lint inicializan ese entorno cuando es necesario. make all reconstruye y activa intencionadamente el checkout actual para desarrollo local; los objetivos de nivel inferior make install, make dev-install y scripts/install-dev.sh aplican reglas de propiedad del código fuente y no son una vía de actualización. Las instalaciones de versión se actualizan con defenseclaw upgrade, que ejecuta el instalador de la última versión; consulta la página de actualización.

Las principales áreas de código fuente son:

Área	Ruta
CLI y TUI en Python	`cli/defenseclaw/`
Comandos del gateway en Go	`cmd/`
Paquetes de implementación en Go	`internal/`
Extensión de OpenClaw	`extensions/defenseclaw/`
Paquetes de políticas	`policies/`
Esquemas versionados	`schemas/`
Automatización de versiones y desarrollo	`scripts/`
Pruebas y fixtures	`test/` y archivos `_test.` locales de cada componente

Consulta CONTRIBUTING.md para el flujo de trabajo de pull requests y SECURITY.md para el reporte privado de vulnerabilidades.

Licencia

Apache-2.0. Consulta LICENSE y NOTICE.

defenseclaw v0.8.8