config-guard は何をしますか?
設定変更の検証、自動バックアップ、スキーマ検証、自動ロールバックにより、AIエージェントがOpenClawをクラッシュさせるのを防ぎます。
概要
このスキルは、AIエージェントがOpenClawの設定ファイルを変更する際に、システムの安定性を保証するためのガード機構を提供します。設定変更前の自動バックアップ、設定値のスキーマ検証、問題発生時の自動ロールバックを実行します。
機能
- 自動バックアップ: 設定変更前に既存の設定ファイルを自動的にバックアップします。
- スキーマ検証: 変更内容を定義済みスキーマと照合し、無効な設定値の適用を防ぎます。
- 自動ロールバック: 設定変更後にOpenClawのクラッシュを検出した場合、自動的に設定をバックアップから復元します。
使用方法
# 設定変更を行う前に、config-guardを有効化
config-guard enable
# 設定ファイルを変更(例:OpenClawの設定)
openclaw config set some.key=value
# config-guardが自動的にバックアップと検証を実行
# 問題がなければ変更が適用され、問題があればロールバック
対応プラットフォーム
- Claude Code
- Cursor
- Codex
- その他のAIエージェントツール
動作の仕組み
-
バックアップフェーズ:
- 設定変更が検出されると、config-guardは既存の設定ファイルを
~/.config-guard/backups/ディレクトリにコピーします。 - バックアップファイルにはタイムスタンプが付与され、復元ポイントとして使用されます。
- 設定変更が検出されると、config-guardは既存の設定ファイルを
-
検証フェーズ:
- 変更された設定値を、OpenClawのスキーマ定義と照合します。
- 無効なキーや値の範囲外の値が指定された場合、変更はブロックされます。
-
ロールバックフェーズ:
- OpenClawのプロセスを監視し、設定変更後にクラッシュが発生した場合、自動的にバックアップから設定を復元します。
- ロールバックが成功したかどうかを標準出力に通知します。
環境変数
CONFIG_GUARD_ENABLED:trueまたはfalseで有効/無効を切り替え(デフォルト:true)CONFIG_GUARD_BACKUP_DIR: バックアップディレクトリのパス(デフォルト:~/.config-guard/backups/)CONFIG_GUARD_SCHEMA_PATH: 使用するスキーマファイルのパス(デフォルト: 組み込みスキーマ)
注意事項
- このスキールはOpenClawの設定変更にのみ適用されます。他のアプリケーションの設定変更には影響しません。
- バックアップは設定変更前に自動的に作成されるため、手動でバックアップを取る必要はありません。
- ロールバックが頻発する場合は、スキーマ定義や設定値を見直すことを推奨します。
ライセンス
MIT