clauditor

🛡️ AI Agent 防篡改审计看门狗

Apollo Street 出品的系统级安全审计工具,通过 HMAC 链式日志为 AI Agent 提供防篡改的文件系统监控,即使主程序被入侵也无法销毁证据。

收藏
4.3k
安装
1.1k
版本
v0.1.2
CLS 安全性认证2026-07-10
点击查看完整报告 >

使用说明

核心用法

Clauditor 是一款专为 Clawdbot 等 AI Agent 设计的防篡改审计看门狗,采用向导式安装流程降低使用门槛。用户通过 ./clauditor wizard 命令按 6 步引导完成系统用户创建、systemd 服务配置、HMAC 密钥生成等操作,每步均需用户手动执行 sudo 命令并验证。安装完成后,服务以独立 sysaudit 用户运行,持续监控指定路径的文件系统活动与进程执行,生成链式 HMAC 签名日志。用户可通过 digest 子命令将原始日志转换为可读的 Markdown 审计报告,支持检测可疑命令序列(如凭证读取后接网络操作)、首次执行命令标记、孤儿进程识别等高级分析功能。

显著优点

架构安全设计突出:采用权限分离原则,监控服务以低权限系统用户运行,与主 Agent 隔离;HMAC-SHA256 链式验证确保日志一旦写入即无法被任何单一实体(包括 root)篡改或删除,实现真正的不可否认性。技术实现严谨:Rust 内存安全语言编写,消除缓冲区溢出风险;常量时间比较防御时序攻击;路径遍历防护完善。运维友好:向导式安装降低系统级工具的使用门槛;--dry-run 模式支持预览;双模式收集器兼顾开发调试(inotify 无特权)与生产部署(fanotify 全功能)。检测能力丰富:内置可疑行为序列检测、基线学习、会话外进程标记等主动防御机制。

潜在缺点与局限性

平台锁定严重:仅支持 Linux 系统,依赖 fanotify 与 systemd,无法跨平台部署。权限要求苛刻:生产模式需要 root/CAP_SYS_ADMIN 权限,在容器化、Serverless 或高安全隔离环境中难以满足。性能开销:文件系统事件监控与 HMAC 计算会产生持续的系统负载,对延迟敏感型工作负载不友好。密钥管理负担:HMAC 密钥丢失将导致历史日志无法验证,但文档未提供自动化备份方案。生态封闭:专为 Clawdbot 生态设计,与其他 AI Agent 框架的集成需额外适配。

适合的目标群体

  • 运行 Clawdbot 或其他 AI Agent 且需满足合规审计要求的企业安全团队
  • 对 AI 系统行为可追溯性有高要求的金融、医疗、政务等敏感行业
  • 具备 Linux 系统管理能力的 DevSecOps 工程师与平台安全架构师
  • 需要向监管机构证明 AI 系统未被恶意操控的合规官

使用风险

供应链风险:虽依赖 crates.io 标准库,但 T2 来源意味着需自行承担 Apollo Street 组织的长期维护风险。配置误用风险watch_paths 配置不当可能导致日志膨胀或监控盲区;target_uid 设置错误将漏过关键进程。密钥泄露风险:HMAC 密钥权限为 640,若 root 账户被入侵,攻击者虽无法删除日志但可能获取密钥伪造新条目(无法篡改历史)。告警疲劳:未合理配置冷却机制可能导致告警风暴,反而掩盖真实威胁。

安全解读

Clauditor是一款专为Clawdbot代理设计的安全审计watchdog工具,核心功能是通过内核级文件监控(fanotify/inotify)实时检测并记录可疑文件系统活动,并生成HMAC链式防篡改日志证据。

核心用法
安装采用向导式CLI流程,分6步完成:创建独立系统用户(sysaudit)、安装systemd服务、配置fanotify监控、设置日志目录权限、生成加密密钥、启动监控服务。用户可通过./clauditor wizard命令逐步执行,每步均有明确的WHAT/WHY/COMMAND说明。日常运维使用systemctl status systemd-journaldd检查服务状态,clauditor digest生成Markdown格式审计报告。

显著优点
1. 防篡改架构:日志采用HMAC链式签名,即使攻击者获取root权限也无法伪造或删除历史记录;独立用户权限隔离确保watchdog进程无法被目标代理终止

2. 隐蔽部署:使用systemd-journaldd伪装服务名和隐藏路径.sysd/.audit,降低被恶意代理识别绕过的概率

3. 精准监控:通过target_uid配置仅监控特定代理进程,避免全系统开销

4. 内存安全:Rust编写,消除C/C++常见的缓冲区溢出等内存漏洞

5. 全面检测:内置规则覆盖数据外泄(curl/scp/ssh)、命令注入(bash/python -c)、持久化攻击(crontab/systemctl)和日志篡改(rm -rf/chattr)

潜在缺点与局限性
1. Linux专属:依赖fanotify和systemd,macOS/Windows不支持

2. root权限强依赖:安装必须sudo,存在权限提升攻击面

3. eval执行风险:安装脚本使用eval执行动态命令,存在注入可能

4. 监控盲区:仅能检测配置路径内的活动,非监控目录的恶意操作无法捕获

5. 资源开销:内核级监控对高IO场景有性能影响

适合人群

  • 部署Clawdbot代理的企业安全团队
  • 需要合规审计留痕的金融/医疗/政务场景
  • 对AI代理行为有强监管需求的敏感环境

常规风险
1. 供应链攻击:安装脚本以root执行,需验证GitHub来源和脚本哈希

2. 配置漂移target_uid配置错误可能导致监控失效或过度告警

3. 日志爆炸:高频IO场景下未配置轮转可能导致磁盘耗尽

4. 误报累积:合法的开发/运维操作可能触发检测规则,需配套白名单机制

clauditor 内容

crates文件夹
alerter文件夹
src文件夹
clauditor-cli文件夹
src文件夹
collector文件夹
src文件夹
detector文件夹
src文件夹
schema文件夹
src文件夹
writer文件夹
src文件夹
wizard文件夹
手动下载zip · 60.0 kB
lib.rstext/plain
请选择文件