mcpField
W
workspace-integrity-guardian

workspace-integrity-guardian

github.com/archieindian安全7343 次安装26 周前更新
代码仓库

关于 workspace-integrity-guardian

这是一项安全技能,用于监控 OpenClaw 工作区中的 Agent 身份和配置文件,发现未授权或意外更改。它保存基准哈希、分类偏移,并让用户选择接受更改或恢复基准。

主要功能

  1. 01计算受保护工作区文件的哈希
  2. 02按周或按需检查偏移
  3. 03分类编辑、截断、替换和删除
  4. 04展示变更摘要并请求处理决定
  5. 05恢复文件或更新基准

适用场景

  1. 01检测 Agent 身份文件变更
  2. 02审查工作区中的意外修改
  3. 03恢复被删除的受保护文件

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/archieindian/openclaw-superpowers --skill workspace-integrity-guardian

安装后在 Claude Code 中输入/workspace-integrity-guardian确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

example-state.yaml
guard.py
STATE_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")。每次唤醒时:

  1. 从状态中读取已存储的基准哈希
  2. 重新计算所有监控文件的哈希
  3. 进行比较——如果任何哈希发生变化,则对变化进行分类
  4. 向用户提示偏差;询问是接受还是还原

偏差分类

变化类型指示操作
仅追加文件增大,已有内容保持不变审查并接受
截断文件明显缩短高优先级警报
完全替换哈希完全不同严重警报
删除文件缺失尝试从基准还原

恢复流程

检测到偏差时:

  1. 显示差异摘要:发生了什么变化、变化幅度,以及时间(文件修改时间)
  2. 询问用户:“接受此更改?”或“从基准还原?”
  3. 如果选择还原:将基准内容写回文件
  4. 如果选择接受:将已存储的基准哈希更新为新哈希
  5. 将决定记录到状态中

与 persistent-memory-hygiene 的区别

persistent-memory-hygiene 强化记忆文件的格式和结构规范(使其保持整洁实用)。此技能只关注完整性:检测 Agent 身份和配置文件是否遭到未经授权或意外的更改。

评论

支持 Markdown