openclaw-warden

🛡️ 工作空间完整性守护者

Agent 环境本地安全监控工具,通过基线校验与注入检测防止配置篡改,纯 Python 标准库运行零依赖。

收藏
15k
安装
3.4k
版本
v1.0.3
CLS 安全性认证2026-05-13
点击查看完整报告 >

使用说明

核心用法

OpenClaw Warden 是一款专为 AI Agent 工作空间设计的完整性监控工具,通过六个核心命令构建安全防护体系。首次使用需运行 baseline 建立文件完整性基线,记录 SOUL.md、AGENTS.md 等关键文件的初始状态。日常运维中,verify 命令可比对当前文件与基线差异,scan 命令专门检测提示注入攻击模式,而 full 命令则一次性完成完整检查。status 提供快速健康概览,accept 用于将合法变更纳入新基线。工具支持环境变量自动检测工作空间,也允许通过 --workspace 参数手动指定路径。

显著优点

该工具最大优势在于零信任架构下的本地防护:完全基于 Python 标准库开发,无 pip 依赖、无网络通信,彻底杜绝供应链攻击风险。检测能力覆盖多种高级攻击向量,包括 Unicode 零宽字符、RTL 覆盖、Base64 隐藏载荷、Markdown 图片外泄通道等。跨平台兼容 OpenClaw、Claude Code、Cursor 等主流 Agent 工具,且具备完善的恢复机制(snapshot restore 与 git rollback),在发现异常时可快速回滚。文件分类监控策略合理区分关键配置与记忆文件的变更敏感度,减少误报。

潜在缺点与局限性

作为 T3 来源的个人项目,代码虽开源但缺乏组织级维护背书,长期更新稳定性存疑。安全机制依赖人工基线维护,若用户在受污染状态下建立基线,后续检测将失去意义。功能仅限于本地文件静态分析,无法检测运行时内存注入或网络层攻击。对于大规模工作空间,完整性校验可能存在性能开销。此外,quarantine 功能会重命名技能目录,虽非删除操作,但仍可能影响正在运行的任务。

适合的目标群体

主要面向高安全敏感度的 Agent 开发者与运维人员,特别是使用 OpenClaw 生态或类似 Agent 框架的技术团队。适用于需要符合合规要求的企业内部开发环境、涉及商业机密的工作空间,以及担心第三方技能包潜在后门的paranoid用户。对于频繁安装外部 Skills、启用 heartbeat 功能或共享工作空间的场景尤为必要。

使用风险与注意事项

尽管安全评级为 A,仍需注意:工具使用 subprocess 执行 git 命令用于回滚功能,虽仅限于已验证的 git 目录,但仍需确保工作空间 Git 配置安全。具备目录重命名权限的 quarantine 功能可能误隔离合法变更,建议生产环境先在测试库验证规则。由于无网络能力,无法实时更新威胁特征库,需关注项目更新手动升级。建议配合定期备份策略使用,避免单点依赖。

安全解读

核心用法

OpenClaw Warden 是一套工作区安全监控工具,通过 Python 脚本实现三大核心功能:

  • 基线建立 (baseline):对关键文件生成哈希快照,建立可信状态
  • 完整性验证 (verify):比对当前文件与基线,发现修改、删除或新增
  • 注入扫描 (scan):检测隐藏指令、Base64 载荷、Unicode 技巧、Markdown 外泄 URL 等攻击模式

支持 full 组合命令和 status 快速概览,变更可通过 accept 更新基线。

显著优点

1. 填补安全盲区:现有工具仅在安装前扫描 skill,Warden 在安装后持续监控工作区本身
2. 零依赖设计:纯 Python 标准库,无 pip 安装,无网络调用,彻底杜绝供应链攻击

3. 精准检测:覆盖 7 大类注入模式,包括零宽字符、RTL 覆盖、系统提示词标记等高级攻击

4. 智能分级:关键文件(SOUL.md/IDENTITY.md 等)与内存文件差异化告警,减少误报

5. 跨平台兼容:支持 OpenClaw、Claude Code、Cursor 等主流 Agent 框架

潜在局限

  • 本地防护边界:仅监控文件系统,无法检测运行时内存篡改或外部 API 污染
  • 基线依赖:需用户主动建立基线,初始设置阶段存在空窗期
  • 误报可能:合法的大段 Base64 或特殊 Unicode 排版可能触发扫描警报
  • 单工作区局限:需为每个工作区单独配置,无集中式多工作区管理

适合人群

  • 使用 AI Agent 处理敏感代码或数据的开发者
  • 需要审计 Agent 行为一致性的安全团队
  • 担心 skill 供应链攻击或提示词注入的高级用户
  • 遵循最小权限原则、偏好无外部依赖工具的技术人员

常规风险

  • 基线文件本身需妥善保护,若被篡改将导致监控失效
  • 过度依赖可能产生"安全幻觉",需配合网络层和权限控制使用
  • 环境变量 OPENCLAW_WORKSPACE 配置错误可能导致监控范围偏差

openclaw-warden 内容

scripts文件夹
手动下载zip · 12.9 kB
integrity.pytext/plain
请选择文件