workspace-integrity-guardian について
OpenClaw ワークスペース内のエージェントの ID と設定ファイルを監視し、不正または偶発的な変更を検出するセキュリティスキルです。基準ハッシュを保存して変更を分類し、変更の承認または復元を促します。
主な機能
- 01保護対象のワークスペースファイルをハッシュ化
- 02週次またはオンデマンドで変更を確認
- 03編集、切り詰め、置換、削除を分類
- 04変更概要を表示して判断を求める
- 05ファイルの復元または基準の更新
活用シーン
- 01エージェント ID ファイルの変更検出
- 02予期しないワークスペース編集の確認
- 03削除された保護ファイルの復元
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/workspace-integrity-guardianを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
example-state.yamlguard.pySTATE_SCHEMA.yaml詳細
workspace-integrity-guardian
SOUL.md、AGENTS.md、MEMORY.md、IDENTITY.md は、エージェントの永続的なアイデンティティを定義します。これらのファイルは、エージェント自身によって誤って上書きされたり、スキルの実行失敗時に破損したり、悪意のあるインストール済みスキルによって変更されたりする可能性があります。SOUL.md のドキュメントでは、次のように警告されています。「侵害された SOUL.md は、再起動後も存続する、恒久的に乗っ取られたエージェントを意味します。」
このスキルは、初回実行時にすべての重要なワークスペースファイルのハッシュを記録し、その後は週次スケジュールとオンデマンドで変更の有無を確認します。
保護対象ファイル
デフォルトでは、以下のファイルを監視します。
~/.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"）。起動のたびに、次の処理を行います。
- state から保存済みのベースラインハッシュを読み込む
- 監視対象のすべてのファイルを再度ハッシュ化する
- 比較し、ハッシュに変更があれば変更を分類する
- 変更をユーザーに提示し、承認するか復元するかを確認する
変更の分類
| 変更の種類 | 指標 | 対応 |
|---|---|---|
| 追記のみ | ファイルが大きくなり、既存の内容はそのまま | 確認して承認 |
| 切り詰め | ファイルが大幅に小さくなった | 優先度の高いアラート |
| 全面置換 | ハッシュが完全に異なる | 重大なアラート |
| 削除 | ファイルが存在しない | ベースラインからの復元を試みる |
復旧手順
変更が検出された場合：
- 差分の概要（変更内容、変更量、変更時刻（ファイルの mtime））を表示する
- ユーザーに「この変更を承認しますか？」または「ベースラインから復元しますか？」と確認する
- 復元する場合：ベースラインの内容をファイルに書き戻す
- 承認する場合：保存済みのベースラインハッシュを新しいハッシュに更新する
- 判断内容を state に記録する
persistent-memory-hygiene との違い
persistent-memory-hygiene は、メモリファイルの書式と構造を整えることで、ファイルを整理された有用な状態に保ちます。このスキルは整合性のみを扱い、エージェントのアイデンティティファイルや設定ファイルへの未承認または偶発的な変更を検出します。