关于 workspace-integrity-guardian
这是一项安全技能,用于监控 OpenClaw 工作区中的 Agent 身份和配置文件,发现未授权或意外更改。它保存基准哈希、分类偏移,并让用户选择接受更改或恢复基准。
主要功能
- 01计算受保护工作区文件的哈希
- 02按周或按需检查偏移
- 03分类编辑、截断、替换和删除
- 04展示变更摘要并请求处理决定
- 05恢复文件或更新基准
适用场景
- 01检测 Agent 身份文件变更
- 02审查工作区中的意外修改
- 03恢复被删除的受保护文件
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ archieindian/ openclaw-superpowers --skill workspace-integrity-guardian安装后在 Claude Code 中输入/workspace-integrity-guardian确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
example-state.yamlguard.pySTATE_SCHEMA.yaml详细介绍
workspace-integrity-guardian
SOUL.md、AGENTS.md、MEMORY.md 和 IDENTITY.md 定义了 Agent 的持久身份。这些文件可能被 Agent 意外覆盖、在技能执行失败时损坏,或被恶意安装的技能篡改。SOUL.md 文档警告道:“遭到入侵的 SOUL.md 意味着 Agent 被永久劫持,即使重启也无法恢复。”
此技能会在首次运行时对所有关键工作区文件进行哈希处理,之后按每周计划并根据需要检查是否出现偏差。
受保护的文件
默认监控以下文件:
~/.openclaw/workspace/SOUL.md~/.openclaw/workspace/AGENTS.md~/.openclaw/workspace/MEMORY.md~/.openclaw/workspace/IDENTITY.md
添加自定义文件:
python3 guard.py --add-file ~/.openclaw/workspace/MY_RULES.md
Cron 唤醒行为
每周日 03:00 运行(cron: "0 3 * * 0")。每次唤醒时:
- 从状态中读取已存储的基准哈希
- 重新计算所有监控文件的哈希
- 进行比较——如果任何哈希发生变化,则对变化进行分类
- 向用户提示偏差;询问是接受还是还原
偏差分类
| 变化类型 | 指示 | 操作 |
|---|---|---|
| 仅追加 | 文件增大,已有内容保持不变 | 审查并接受 |
| 截断 | 文件明显缩短 | 高优先级警报 |
| 完全替换 | 哈希完全不同 | 严重警报 |
| 删除 | 文件缺失 | 尝试从基准还原 |
恢复流程
检测到偏差时:
- 显示差异摘要:发生了什么变化、变化幅度,以及时间(文件修改时间)
- 询问用户:“接受此更改?”或“从基准还原?”
- 如果选择还原:将基准内容写回文件
- 如果选择接受:将已存储的基准哈希更新为新哈希
- 将决定记录到状态中
与 persistent-memory-hygiene 的区别
persistent-memory-hygiene 强化记忆文件的格式和结构规范(使其保持整洁实用)。此技能只关注完整性:检测 Agent 身份和配置文件是否遭到未经授权或意外的更改。
评论
支持 Markdown