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

DefenseClaw combina una CLI operatore in Python, un gateway in Go, hook per i connettori, policy, scanner ed esportatori di osservabilità. È un livello di enforcement e di evidenza; non dimostra che un agente, un'interazione con un modello o una capacità di terze parti sia priva di rischi.

Gli hook falliscono in modalità chiusa per impostazione predefinita. Solo i deployment di Cisco Secure Client impostano per default la consegna degli hook in modalità aperta quando non è specificata alcuna policy; in quel caso un'impostazione esplicita di fail-closed e i dinieghi validi della policy restano efficaci. Consulta Fail modes per l'ambito di Secure Client.

Per iniziare

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

Poi leggi la documentazione. Su Windows nativo, consulta Install DefenseClaw.

Documentazione

Il sito della documentazione di DefenseClaw è la fonte di riferimento per installazione, configurazione, comandi e flussi di lavoro dell'operatore:

Il Markdown del repository è limitato a linee guida per i contributori, contratti di implementazione, note locali ai pacchetti, riferimenti a schemi generati, fixture di test e registrazioni storiche di progettazione. Inizia da docs/README.md.

Sviluppo dal sorgente

I target sorgente sono strumenti per i contributori. Non costituiscono un percorso di installazione o aggiornamento per un host gestito tramite release; per tali attività usa le guide del sito web indicate sopra. I contratti della toolchain versionati nel repository sono Python >=3.10,<3.14 (pyproject.toml) e Go 1.26.4 (go.mod). La CI verifica i componenti 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 artefatti di checkout senza pubblicarli o modificare lo stato dell'installazione gestita; il suo passo pycli può creare o aggiornare il .venv condiviso locale al repository. Esegui make help prima di utilizzare i target sorgente che modificano lo stato. Tutti i target sorgente locali condividono quell'unico .venv bloccato e pronto per i test; non esiste un ambiente Python separato di produzione rispetto a quello di sviluppo da selezionare. make test, make check e make py-lint inizializzano quell'ambiente quando necessario. make all ricostruisce e attiva intenzionalmente il checkout corrente per lo sviluppo locale; i target di livello inferiore make install, make dev-install e scripts/install-dev.sh applicano le regole di proprietà del sorgente e non costituiscono un percorso di aggiornamento. Le installazioni di release si aggiornano con defenseclaw upgrade, che esegue l'installer dell'ultima release; vedi la pagina di aggiornamento.

Le principali aree sorgente sono:

Vedi CONTRIBUTING.md per il flusso di lavoro delle pull request e SECURITY.md per la segnalazione privata delle vulnerabilità.

Licenza

Apache-2.0. Vedi LICENSE e NOTICE.

Copyright 2026 Cisco Systems, Inc. e le sue affiliate.