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

DefenseClaw combina una CLI de operador en Python, una puerta de enlace en Go, hooks de conector, 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.

Los hooks fallan cerrados por defecto. Solo las implementaciones de Cisco Secure Client establecen por defecto la entrega de hooks en modo fail-open cuando no se especifica ninguna política; allí siguen siendo efectivos un ajuste explícito de fail-closed y las denegaciones de política válidas. Consulte Modos de fallo para el alcance de Secure Client.

Primeros pasos

curl -LsSf https://github.com/cisco-ai-defense/defenseclaw/releases/latest/download/install.sh | bash
defenseclaw quickstart

A continuación, lea la documentación. En Windows nativo, consulte Instalar DefenseClaw.

Documentación

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

El Markdown del repositorio se limita a la guía para colaboradores, los contratos de implementación, las notas locales de cada paquete, las referencias de esquema generadas, los fixtures de prueba y los registros históricos de diseño. Comience en docs/README.md.

Desarrollo desde el código fuente

Los destinos de código fuente son herramientas para colaboradores. No constituyen una vía de instalación ni de actualización para un host gestionado por versiones; utilice las guías del sitio web anteriores para esas tareas. Los contratos de la cadena de herramientas registrados en el repositorio son Python >=3.10,<3.14 (pyproject.toml) y Go 1.26.4 (go.mod). La CI ejercita 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 de compilación sin publicarlos ni cambiar el estado de la instalación gestionada; su paso pycli puede crear o actualizar el .venv compartido local al repositorio. Ejecute make help antes de usar objetivos de código fuente que cambian el estado. Todos los objetivos locales de código fuente comparten ese único .venv bloqueado y listo para pruebas; no hay un entorno 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 la compilación actual para el 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; consulte la página de actualización.

Las principales áreas de código fuente son:

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

Licencia

Apache-2.0. Consulte LICENSE y NOTICE.

Copyright 2026 Cisco Systems, Inc. y sus filiales.