
defenseclaw v0.8.8
Sicherheits-Governance für agentische KI
____ ____ ____ _
/ __ \ ___ / __/___ ___ ___ ___ / ___|| | __ _ __ __
/ / / / / _ \/ /_// _ \ / _ \ / __|/ _ \| | | |/ _` |\ \ /\ / /
/ /_/ / / __/ __// __/| | | |\__ \ __/| |___ | | (_| | \ V V /
/_____/ \___/_/ \___/ |_| |_||___/\___| \____||_|\__,_| \_/\_/
DefenseClaw
Sicherheits-Governance für KI-Coding-Agenten und agentische Laufzeitumgebungen.
Fähigkeiten vor der Nutzung scannen, Laufzeitverkehr inspizieren und dauerhafte Audit-Nachweise exportieren.
DefenseClaw kombiniert eine Python-Operator-CLI, ein Go-Gateway, Connector-Hooks, Richtlinien, Scanner und Observability-Exporter. Es ist eine Durchsetzungs- und Nachweisschicht; es beweist nicht, dass ein Agent, eine Modellinteraktion oder eine Drittanbieter-Fähigkeit risikofrei ist.
Hooks schlagen standardmäßig geschlossen fehl (fail closed). Nur bei Cisco Secure Client-Bereitstellungen ist die Hook-Zustellung standardmäßig auf Fail-Open gesetzt, wenn keine Richtlinie angegeben ist; dort bleiben eine explizite Fail-Closed-Einstellung und gültige Richtlinien-Ablehnungen wirksam. Siehe Fail modes für den Geltungsbereich von Secure Client.
Erste Schritte
curl -LsSf https://github.com/cisco-ai-defense/defenseclaw/releases/latest/download/install.sh | bash
defenseclaw quickstart
Lies dann die Dokumentation. Unter nativem Windows siehe DefenseClaw installieren.
Dokumentation
Die DefenseClaw-Dokumentationswebsite ist die maßgebliche Quelle für Installation, Einrichtung, Konfiguration, Befehle und Betreiber-Workflows:
| Thema | Maßgeblicher Leitfaden |
|---|---|
| Installation | DefenseClaw installieren |
| Erster Start | Quickstart |
| Upgrade | Upgrade |
| Windows | Natives Windows |
| Konnektoren | Konnektor-Kompatibilität |
| Guardrails | Guardrail-Einrichtung |
| Konfiguration | Konfigurationsreferenz |
| CLI | CLI-Referenz |
| Observability | Observability |
Markdown im Repository ist beschränkt auf Mitwirkenden-Hinweise, Implementierungs-
Verträge, paketlokale Notizen, generierte Schema-Referenzen, Test-Fixtures und
historische Design-Aufzeichnungen. Beginne bei docs/README.md.
Quellcode-Entwicklung
Quellcode-Ziele sind Werkzeuge für Mitwirkende. Sie sind kein Installations- oder Upgrade-
Pfad für einen release-verwalteten Host; verwende für diese Aufgaben die oben genannten
Website-Leitfäden. Die eingecheckten Toolchain-Verträge sind Python >=3.10,<3.14
(pyproject.toml) und Go 1.26.4
(go.mod). CI testet die TypeScript-Komponenten mit 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 erzeugt Checkout-Artefakte, ohne sie zu veröffentlichen oder den
verwalteten Installationszustand zu ändern; sein pycli-Schritt kann die
gemeinsame, repository-lokale .venv erstellen oder aktualisieren. Führen Sie
make help aus, bevor Sie zustandsändernde Source-Targets verwenden. Alle
lokalen Source-Targets teilen sich diese eine gesperrte, testbereite .venv;
es gibt keine separate Python-Umgebung für Produktion versus Entwicklung, die
ausgewählt werden müsste. make test, make check und make py-lint
initialisieren diese Umgebung bei Bedarf. make all baut den aktuellen
Checkout absichtlich neu und aktiviert ihn für die lokale Entwicklung; die
niedrigeren Targets make install, make dev-install und
scripts/install-dev.sh erzwingen Source-Ownership-Regeln und sind kein
Upgrade-Pfad. Release-Installationen werden mit defenseclaw upgrade
aktualisiert, was den Installer des neuesten Releases ausführt; siehe die
Upgrade-Seite.
Die wichtigsten Source-Bereiche sind:
| Bereich | Pfad |
|---|---|
| Python-CLI und TUI | cli/defenseclaw/ |
| Go-Gateway-Befehle | cmd/ |
| Go-Implementierungspakete | internal/ |
| OpenClaw-Erweiterung | extensions/defenseclaw/ |
| Policy-Bundles | policies/ |
| Versionierte Schemas | schemas/ |
| Release- und Entwickler-Automatisierung | scripts/ |
| Tests und Fixtures | test/ und komponentenlokale *_test.*-Dateien |
Siehe CONTRIBUTING.md für den Pull-Request-Workflow und
SECURITY.md für die private Meldung von Schwachstellen.
Lizenz
Apache-2.0. Siehe LICENSE und NOTICE.
Copyright 2026 Cisco Systems, Inc. und seine verbundenen Unternehmen.