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

O DefenseClaw combina uma CLI de operador em Python, um gateway em Go, hooks de conector, política, scanners e exportadores de observabilidade. É uma camada de aplicação de políticas e evidências; não prova que um agente, uma interação com modelo ou uma capacidade de terceiros esteja livre de riscos.

Os hooks falham fechados por padrão. Apenas implantações do Cisco Secure Client definem a entrega de hooks como fail-open por padrão quando nenhuma política é especificada; nesse caso, uma configuração explícita de fail-closed e negações de política válidas permanecem efetivas. Consulte Modos de falha para o escopo do Secure Client.

Primeiros passos

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

Em seguida, leia a documentação. No Windows nativo, consulte Instalar o DefenseClaw.

Documentação

O site de documentação do DefenseClaw é a fonte de referência para instalação, configuração, comandos e fluxos de trabalho do operador:

O Markdown do repositório limita-se a orientações para contribuidores, contratos de implementação, notas locais de pacotes, referências de esquema geradas, fixtures de teste e registros históricos de design. Comece por docs/README.md.

Desenvolvimento a partir do código-fonte

Os alvos de código-fonte são ferramentas para contribuidores. Não constituem um caminho de instalação ou atualização para um host gerido por releases; use os guias do site acima para essas tarefas. Os contratos de toolchain versionados são Python >=3.10,<3.14 (pyproject.toml) e Go 1.26.4 (go.mod). A CI exercita os componentes TypeScript com 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 produz artefatos de checkout sem publicá-los ou alterar o estado da instalação gerenciada; sua etapa pycli pode criar ou atualizar o .venv compartilhado no repositório local. Execute make help antes de usar alvos de origem que alteram estado. Todos os alvos de origem locais compartilham esse único .venv bloqueado e pronto para testes; não há um ambiente Python separado de produção versus desenvolvimento a selecionar. make test, make check e make py-lint inicializam esse ambiente quando necessário. make all intencionalmente reconstrói e ativa o checkout atual para desenvolvimento local; os alvos de nível inferior make install, make dev-install e scripts/install-dev.sh aplicam regras de propriedade de origem e não são um caminho de atualização. As instalações de versão são atualizadas com defenseclaw upgrade, que executa o instalador da versão mais recente; consulte a página de atualização.

As principais áreas de origem são:

Consulte CONTRIBUTING.md para o fluxo de trabalho de pull request e SECURITY.md para relato privado de vulnerabilidades.

Licença

Apache-2.0. Consulte LICENSE e NOTICE.

Copyright 2026 Cisco Systems, Inc. e suas afiliadas.