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

DefenseClaw

Gouvernance de sécurité pour OpenClaw et les runtimes d'IA agentique.
Analysez les capacités avant utilisation, inspectez le trafic d'exécution et exportez des preuves d'audit durables.

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 :

Sujet	Guide de référence
Installation	Installer DefenseClaw
Premier lancement	Démarrage rapide
Mise à niveau	Mise à niveau
Windows	Windows natif
Connecteurs	Compatibilité des connecteurs
Garde-fous	Configuration des garde-fous
Configuration	Référence de configuration
CLI	Référence CLI
Observabilité	Observabilité

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 :

Zone	Chemin
CLI et TUI Python	`cli/defenseclaw/`
Commandes de la passerelle Go	`cmd/`
Paquets d'implémentation Go	`internal/`
Extension OpenClaw	`extensions/defenseclaw/`
Lots de politiques	`policies/`
Schémas versionnés	`schemas/`
Automatisation des releases et des développeurs	`scripts/`
Tests et fixtures	`test/` et fichiers `_test.` locaux aux composants

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.

defenseclaw v0.8.8