← 返回 Skills 市场
3875
总下载
1
收藏
38
当前安装
3
版本数
在 OpenClaw 中安装
/install soul-guardian
功能描述
Drift detection + baseline integrity guard for agent workspace files with automatic alerting support
安全使用建议
Install only after initializing baselines from known-good files. Use --no-restore or change the policy to alert-only if you do not want automatic overwrites, keep the state directory private, and enable cron or launchd only when you want ongoing background enforcement.
功能分析
Type: OpenClaw Skill
Name: soul-guardian
Version: 0.0.6
The soul-guardian skill is a comprehensive file integrity monitoring tool designed to protect agent workspace files (like SOUL.md and AGENTS.md) from unauthorized modifications. It implements robust security practices including SHA256 hashing for baselines, atomic file writes, and a tamper-evident audit log using hash chaining in `soul_guardian.py`. While it includes scripts for macOS persistence via launchd (`install_launchd_plist.py`) and file restoration capabilities, these are transparently documented and strictly aligned with the tool's stated purpose of maintaining workspace integrity. No evidence of data exfiltration, malicious prompt injection, or unauthorized remote execution was found.
能力评估
Purpose & Capability
The file hashing, diffing, audit logging, quarantine copies, and restore behavior match the stated purpose, but auto-restoring SOUL.md and AGENTS.md is high-impact if the baseline is wrong or stale.
Instruction Scope
The protected file list and restore/alert modes are documented; some trigger phrases are broad, so users should invoke it intentionally for integrity tasks.
Install Mechanism
Installation and use are local Python workflows; cron, heartbeat, watch mode, and launchd scheduling are documented and opt-in, with launchd loading requiring an explicit install flag.
Credentials
The default behavior is local-only and proportionate, but the state directory can contain sensitive approved snapshots, patches, and quarantined copies of workspace instruction files.
Persistence & Privilege
No hidden persistence or privilege escalation was found; persistence is available only through documented heartbeat, cron, watch, or launchd setup.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install soul-guardian - 安装完成后，直接呼叫该 Skill 的名称或使用
/soul-guardian触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v0.0.6
Release 0.0.6 via CI
v0.0.5
Release 0.0.5 via CI
v0.0.2
Release 0.0.2 via CI
元数据
常见问题
soul-guardian 是什么？
Drift detection + baseline integrity guard for agent workspace files with automatic alerting support. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 3875 次。
如何安装 soul-guardian？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install soul-guardian」即可一键安装，无需额外配置。
soul-guardian 是免费的吗？
是的，soul-guardian 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
soul-guardian 支持哪些平台？
soul-guardian 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 soul-guardian？
由 davida-ps（@davida-ps）开发并维护，当前版本 v0.0.6。
推荐 Skills