Clauditor

核心用法

Clauditor 是一款专为 Clawdbot 代理设计的文件系统安全审计 watchdog，通过创建隔离的系统用户和 systemd 服务，持续监控预定义路径的文件活动。其核心工作流程分为引导式安装和运行时监控两阶段：

• 引导式安装：通过交互式 CLI wizard 分 6 步完成部署，每步包含 status/next/verify 子命令，确保用户理解操作目的后再执行特权命令
• 运行时监控：以独立 sysaudit 用户身份运行，日志写入受保护路径 /var/lib/.sysd/.audit/events.log，支持生成带 HMAC 签名的 Markdown 格式审计摘要

显著优点

1. 隔离性设计：审计进程与 Clawdbot 主进程分离用户身份， compromise 无法直接终止或篡改
2. 防篡改日志：HMAC 链式结构使任何单条记录被修改都会导致验证失败
3. 低侵入部署：提供渐进式 wizard 安装，降低误配置风险

潜在局限

• Linux 专用：明确依赖 systemctl 和 Linux 用户管理机制，无跨平台支持
• 构建依赖：需本地 Rust/Cargo 环境，无法直接下载二进制分发
• 隐蔽目录命名：日志路径使用 .sysd 等伪装名称，虽增强隐蔽性但也增加运维排查难度
• 配置刚性：watch_paths 和 target_uid 需手动编辑 TOML，无动态重载机制

适合人群

• 运行 Clawdbot 代理且需合规审计日志的企业/团队
• 具备 Linux 系统管理能力的安全运维人员
• 对供应链攻击和内部威胁有防护需求的高安全场景

常规风险

• 服务伪装风险：systemd 服务命名为 systemd-journaldd（双 d），可能与真实 journald 混淆，存在社会工程利用空间
• 密钥管理：HMAC 密钥明文存储于 /etc/sysaudit/key，需额外依赖文件系统权限保护
• wizard.sh 快速安装：一键脚本跳过步骤验证，可能因环境差异导致配置不完整
• 供应链盲区：源码仓库 apollostreetcompany/clauditor 需审计 Rust 依赖 crates 的可信度

核心用法

Clauditor 是 Apollo Street Company 开发的安全审计工具，专为 Clawdbot Agent 设计。它通过 fanotify 系统调用 监控指定 UID 用户的文件执行活动，并生成防篡改日志。

安装流程：采用交互式向导（6步安装），引导用户创建独立系统用户、配置 systemd 服务、设置密钥和日志路径。支持 cargo build 手动编译或 wizard.sh 快速安装。

关键命令：

• ./clauditor wizard status/next/verify - 分步安装向导
• ./clauditor digest --log ... --key ... - 生成 HMAC 验证的审计摘要
• systemctl status systemd-journaldd - 查看服务状态（伪装服务名）

核心机制：日志采用链式 HMAC 签名，每条记录包含前一条的哈希值，任何篡改都会破坏链完整性；日志文件设置 append-only 属性（chattr +a），即使 root 也无法删除或修改历史记录。

---

显著优点

1. 真正的防篡改设计：分层权限架构（独立用户 + 不可变日志 + 链式签名），攻击者即使获取 root 也无法抹除证据
2. 透明可信：Rust 原生开发，1500+ 行代码经静态分析无恶意特征，依赖均为标准生态库
3. 零网络依赖：纯本地系统调用，无数据外泄风险
4. 灵活的监控范围：可通过 watch_paths 和 target_uid 自定义监控对象

---

潜在局限

1. 需要 root/CAP_SYS_ADMIN 权限：fanotify 和 chattr 需要系统级权限，无法在普通用户环境运行
2. 隐蔽路径可能引发困惑：使用 /var/lib/.sysd/.audit 和 systemd-journaldd 伪装名，需管理员熟悉配置
3. 日志膨胀风险：持续监控会产生大量执行记录，需配合日志轮转策略
4. 仅限 Linux 平台：依赖 fanotify，macOS/Windows 不支持

---

适合人群

• Clawdbot 高级用户：需要在 Agent 被入侵后保留取证证据
• 安全敏感场景：处理敏感数据、担心提示词注入或权限提升攻击的用户
• Linux 系统管理员：具备 root 管理权限，熟悉 systemd 和文件属性操作

---

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 安装时 root 权限滥用 | medium | wizard.sh 需要 sudo，需验证脚本来源 |

| 监控范围过宽 | low | 默认监控 `/` 和 `/home/clawdbot`，可能记录无关命令 |

| 服务名伪装 | low | `systemd-journaldd` 易与真实服务混淆 |

| 配置路径遍历 | low | 建议增加输入验证防止路径注入 |

---

安全评分参考

• 综合评分：78/100（Grade A）
• 静态分析：85 ✅ | 动态行为：75 ✅ | 依赖审计：90 ✅ | 网络隔离：95 ✅ | 隐私合规：70 ⚠️