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

DefenseClaw объединяет операторский CLI на Python, шлюз на Go, хуки-коннекторы, политику, сканеры и экспортёры наблюдаемости. Это слой принудительного применения и доказательств; он не доказывает, что агент, взаимодействие с моделью или сторонняя возможность не несут рисков.

Хуки по умолчанию работают по принципу fail-closed. Только развёртывания Cisco Secure Client по умолчанию используют доставку хуков по принципу fail-open, когда политика не задана; там явная настройка fail-closed и действительные отказы по политике остаются в силе. См. Режимы отказа для области действия Secure Client.

Начало работы

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

Затем прочитайте документацию. В нативной Windows см. Установка DefenseClaw.

Документация

Сайт документации DefenseClaw является источником истины по установке, настройке, конфигурации, командам и рабочим процессам оператора:

Markdown в репозитории ограничен руководством для контрибьюторов, контрактами реализации, локальными заметками пакетов, сгенерированными справочниками схем, тестовыми фикстурами и историческими записями о дизайне. Начните с docs/README.md.

Разработка из исходников

Цели сборки из исходников предназначены для инструментов контрибьюторов. Они не являются путём установки или обновления для хоста, управляемого релизами; для этих задач используйте руководства на сайте выше. Зафиксированные в репозитории контракты инструментальной цепочки — Python >=3.10,<3.14 (pyproject.toml) и Go 1.26.4 (go.mod). CI проверяет компоненты TypeScript с помощью 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 создаёт артефакты текущей рабочей копии, не публикуя их и не изменяя состояние управляемой установки; его шаг pycli может создать или обновить общий для репозитория .venv. Перед использованием целей исходного кода, изменяющих состояние, выполните make help. Все локальные цели исходного кода используют один и тот же зафиксированный, готовый к тестированию .venv; отдельного Python-окружения для выбора между production и development нет. make test, make check и make py-lint при необходимости инициализируют это окружение. make all намеренно пересобирает и активирует текущую рабочую копию для локальной разработки; цели более низкого уровня make install, make dev-install и scripts/install-dev.sh обеспечивают соблюдение правил владения исходным кодом и не являются путём обновления. Установки из релизов обновляются с помощью defenseclaw upgrade, который запускает установщик последнего релиза; см. страницу обновления.

Основные области исходного кода:

Рабочий процесс pull-request описан в CONTRIBUTING.md, а порядок приватного сообщения об уязвимостях — в SECURITY.md.

Лицензия

Apache-2.0. См. LICENSE и NOTICE.

Copyright 2026 Cisco Systems, Inc. и её аффилированные лица.