用途：保护智能体工作区中的核心文件（如 SOUL.md、AGENTS.md）免受未授权修改，提供漂移检测、基线完整性校验与自动告警。
主要能力：基于 sha256 检测文件相对已批准基线的漂移；对 SOUL.md 和 AGENTS.md 在漂移时自动还原并告警，对 USER.md、TOOLS.md、IDENTITY.md、HEARTBEAT.md、MEMORY.md 仅告警，memory/*.md 默认忽略；生成统一差异补丁供审阅；维护带哈希链的防篡改审计日志；还原使用原子写入，并拒绝在符号链接上操作。
使用方式：需 python3。安装：npx skills add prompt-security/clawsec --skill soul-guardian -a openclaw -y。初始化基线：python3 skills/soul-guardian/scripts/soul_guardian.py init --actor setup --note "initial baseline"；启用监控：python3 skills/soul-guardian/scripts/soul_guardian.py enable-monitoring；检查漂移：python3 skills/soul-guardian/scripts/soul_guardian.py check --output-format alert；持续监控：python3 skills/soul-guardian/scripts/soul_guardian.py watch --interval 30；批准变更：python3 skills/soul-guardian/scripts/soul_guardian.py approve --file SOUL.md --actor user --note "intentional update"；查看状态：python3 skills/soul-guardian/scripts/soul_guardian.py status；校验审计日志：python3 skills/soul-guardian/scripts/soul_guardian.py verify-audit。可加入 HEARTBEAT.md 自动监控。独立安装需先校验签名发布清单与校验和。
适用场景：智能体工作区核心提示与配置文件变更监控、心跳式巡检、需要自动隔离并还原漂移文件的场合。
限制：无法证明变更者身份，actor 仅为尽力而为的元数据；若攻击者同时控制工作区与状态目录则无法防护；不能替代备份；默认不联网，调度为可选；还原模式会覆盖漂移文件。建议将状态目录放在工作区之外。