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

DefenseClaw combine une CLI opérateur en Python, une passerelle Go, des hooks de connecteurs, une politique, des scanners et des exportateurs d'observabilité. C'est une couche d'application et de preuve ; elle ne prouve pas qu'un agent, une interaction avec un modèle ou une capacité tierce est exempte de risques.

Documentation

Le site de documentation DefenseClaw est la source de référence pour l'installation, la configuration, les commandes et les workflows opérateur :

Le Markdown du dépôt se limite aux conseils aux contributeurs, aux contrats d'implémentation, aux notes locales aux paquets, aux références de schémas générés, aux fixtures de test et aux enregistrements de conception historiques. Commencez par docs/README.md.

Développement depuis les sources

Les cibles source sont des outils pour les contributeurs. Elles ne constituent pas un chemin d'installation ou de mise à niveau pour un hôte géré par une release ; utilisez les guides du site ci-dessus pour ces tâches. Les contrats de chaîne d'outils versionnés sont Python >=3.10,<3.14 (pyproject.toml) et Go 1.26.4 (go.mod). La CI exerce les composants TypeScript avec 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 produit des artefacts de checkout sans les publier ni modifier l'état d'installation géré ; son étape pycli peut créer ou mettre à jour le .venv partagé local au dépôt. Exécutez make help avant d'utiliser des cibles source modifiant l'état. Toutes les cibles source locales partagent ce même .venv verrouillé et prêt pour les tests ; il n'existe pas d'environnement Python distinct production/développement à sélectionner. make test, make check et make py-lint initialisent cet environnement si nécessaire. make all reconstruit et active intentionnellement le checkout courant pour le développement local ; les cibles de plus bas niveau make install, make dev-install et scripts/install-dev.sh appliquent les règles de propriété des sources et ne constituent pas un chemin de mise à niveau. Les installations de release se mettent à niveau avec defenseclaw upgrade, qui exécute l'installateur de la dernière release ; voir la page de mise à niveau.

Les principales zones source sont :

Voir CONTRIBUTING.md pour le workflow de pull-request et SECURITY.md pour le signalement privé de vulnérabilités.

Licence

Apache-2.0. Voir LICENSE et NOTICE.

Copyright 2026 Cisco Systems, Inc. et ses affiliés.