自主AI的安全治理
____ ____ ____ _
/ __ \ ___ / __/___ ___ ___ ___ / ___|| | __ _ __ __
/ / / / / _ \/ /_// _ \ / _ \ / __|/ _ \| | | |/ _` |\ \ /\ / /
/ /_/ / / __/ __// __/| | | |\__ \ __/| |___ | | (_| | \ V V /
/_____/ \___/_/ \___/ |_| |_||___/\___| \____||_|\__,_| \_/\_/
面向 AI 编码代理与代理式运行时的安全治理。
在使用前扫描能力，检查运行时流量，并导出可持久保存的审计证据。
DefenseClaw 集成了 Python 运维 CLI、Go 网关、连接器钩子、策略、扫描器和可观测性导出器。它是一个执行与证据层；它并不能证明某个代理、模型交互或第三方能力是无风险的。
钩子默认采用故障关闭（fail closed）模式。只有 Cisco Secure Client 部署在未指定策略时，钩子交付才默认采用故障开放（fail-open）模式；在该场景下，显式的故障关闭设置和有效的策略拒绝仍然生效。有关 Secure Client 的范围，请参阅故障模式。
curl -LsSf https://github.com/cisco-ai-defense/defenseclaw/releases/latest/download/install.sh | bash
defenseclaw quickstart
然后阅读文档。在原生 Windows 上，请参阅安装 DefenseClaw。
DefenseClaw 文档网站是安装、设置、配置、命令和运维工作流的权威来源：
| 主题 | 权威指南 |
|---|---|
| 安装 | 安装 DefenseClaw |
| 首次运行 | 快速入门 |
| 升级 | 升级 |
| Windows | 原生 Windows |
| 连接器 | 连接器兼容性 |
| 护栏 | 护栏设置 |
| 配置 | 配置参考 |
| CLI | CLI 参考 |
| 可观测性 | 可观测性 |
仓库中的 Markdown 仅限于贡献者指南、实现契约、包内局部说明、生成的 schema 参考、测试夹具和历史设计记录。请从 docs/README.md 开始。
源码目标属于贡献者工具。它们不是由发布版本管理的主机的安装或升级途径；这些任务请使用上方的网站指南。已检入的工具链契约为 Python >=3.10,<3.14（pyproject.toml）和 Go 1.26.4（go.mod）。CI 使用 Node.js 24 测试 TypeScript 组件。
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 环境。make test、make check 和 make py-lint 会在需要时引导该环境。make all 会有意重新构建并激活当前检出，以供本地开发使用；较低层级的 make install、make dev-install 和 scripts/install-dev.sh 目标会强制执行源码归属规则，并不是升级路径。发布版安装通过 defenseclaw upgrade 进行升级，该命令会运行最新发布版的安装程序；请参阅升级页面。
主要源码区域如下：
| 区域 | 路径 |
|---|---|
| Python CLI 和 TUI | cli/defenseclaw/ |
| Go 网关命令 | cmd/ |
| Go 实现包 | internal/ |
| OpenClaw 扩展 | extensions/defenseclaw/ |
| 策略包 | policies/ |
| 版本化 schema | schemas/ |
| 发布与开发者自动化 | scripts/ |
| 测试与测试夹具 | test/ 以及组件本地的 *_test.* 文件 |
拉取请求工作流请参阅 CONTRIBUTING.md，私有漏洞报告请参阅 SECURITY.md。
Apache-2.0。请参阅 LICENSE 和 NOTICE。
Copyright 2026 Cisco Systems, Inc. and its affiliates.