npx -y cc-safety-net@latest install --openclaw を実行すると、OpenClaw 自身の CLI で CC Safety Net が OpenClaw のプラグインとしてインストールされ、プラグインが読み込まれたかも確認されます。その後、OpenClaw Gateway を再起動してください。プラグインは exec の呼び出しを検査し、フェイルクローズで動作します。
OpenClaw に CC Safety Net をインストールする
1
OpenClaw のバージョンを確認する
OpenClaw 2026.8.1 以降を使っていることを確認します。それより古いリリースの場合は、OpenClaw をアップグレードしてください。
2
インストーラーを実行する
3
OpenClaw Gateway を再起動する
Gateway を再起動します。更新やアンインストールの後も同様に再起動してください。
4
プラグインが有効か確認する
openclaw.json に plugins.allow が設定されている場合は、そこに cc-safety-net も記載する必要があります。許可リストに含まれていないと、有効になっていてもプラグインは読み込まれません。OpenClaw のインストールで変わること
インストーラーは、npm パッケージに同梱されたプラグインのディレクトリを指定して、openclaw plugins install を --force --accept-capabilities 付きで実行します。このコマンドはプラグインの有効化も行います。ただし、openclaw.json で自分で無効にしたプラグインは、インストールや更新の後も無効のままです。有効にするには openclaw plugins enable cc-safety-net を実行してください。
OpenClaw のプラグインが読み込まれたことをインストールが確認する仕組み
インストール後、インストーラーはopenclaw plugins inspect cc-safety-net --runtime --json を実行します。状態が loaded 以外であれば、インストールは失敗します。状態が disabled の場合は次のメッセージを表示します。
OpenClaw の設定の場所
インストールとdoctor は OpenClaw と同じ方法でパスを解決するため、場所を移した OpenClaw も見つけられます。
OpenClaw のプラグインが検査する内容
OpenClaw は CC Safety Net をプロセス内のプラグインとして読み込みます。プラグインが検査するのはexec ツールだけで、エージェントのワークスペースディレクトリを基準に検査します。OpenClaw のファイル系ツールは検査しません。
OpenClaw のチェックが失敗したときの動作
プラグインはフェイルクローズで動作します。エージェントのワークスペースを解決できない場合、workdir がワークスペースの外に解決される場合、auto と gateway 以外の実行ホスト（sandbox や node など）が指定された場合は、exec の呼び出しをブロックします。プラグインが例外を投げた場合は、OpenClaw が呼び出しをブロックします。
Gateway の起動時にプラグインの読み込みに失敗すると、Gateway はプラグインなしで動き続け、exec はチェックされずに実行されます。再起動後は、openclaw plugins inspect cc-safety-net --runtime でプラグインが読み込まれたか確認してください。
OpenClaw での保護範囲の制限
- その他のツール。 プラグインは
apply_patchも、OpenClaw の read、write、edit のファイル系ツールも検査しません。Code Mode の JavaScriptexecのようにtoolKindを持つexecイベントには、判定を返しません。 - 設定された既定のホスト。 プラグインが読むのは呼び出し自身の
hostだけです。hostのない呼び出しは、tools.exec.hostによってnodeやsandboxに振り分けられる場合でも、ローカルの Gateway での呼び出しとして検査します。 - サンドボックスでの
auto。 サンドボックスのランタイムが有効な場合、autoの呼び出しはサンドボックスのファイルシステムで実行されますが、プラグインはパスのルールを Gateway のワークスペースを基準に検査します。コマンドのルールには影響しません。 openclaw agent exec。 このコマンドはプラグインのフックレジストリを読み込まないため、CC Safety Net はそのツール呼び出しを検査も監査もしません。同じ呼び出しでも、openclaw agent --localを通せばプラグインが検査します。- Codex ネイティブのリレー。 OpenClaw が中継する Codex ネイティブのシェル、パッチ、MCP の呼び出しについて、CC Safety Net は何も保証しません。
doctorから見える範囲。doctorが読むのはプラグインのディレクトリとopenclaw.jsonだけです。動作中の Gateway に、プラグインが読み込まれたかどうかは問い合わせません。- Windows。 OpenClaw 自身の CLI はプラグインをインストールできますが、
doctorは POSIX の状態ディレクトリ構成を探すため、状態を誤って報告します。
エージェントのワークスペースの外で動くセッション
OpenClaw はexec をセッションの作業ディレクトリで実行します。このディレクトリはエージェントのワークスペースと一致するとは限りません。管理対象のワークツリーを使うセッションは、既定では <state>/worktrees 以下にある専用のチェックアウトで動き、cwd を指定して作成したセッションはその場所で動きます。フックのコンテキストには作業ディレクトリが含まれないため、プラグインはすべての exec の呼び出しをエージェントのワークスペースを基準に検査します。このようなセッションでは、次のようになります。
workdirのないコマンドはワークスペースを基準に検査しますが、実際にはセッションのディレクトリで実行されます。- 相対パスの
workdirは、セッションのディレクトリではなくワークスペースを基準に解決します。 - セッション自身のワークツリーなど、ワークスペースの外を指す絶対パスの
workdirはブロックします。
OpenClaw から CC Safety Net をアンインストールする
OpenClaw のトラブルシューティング
- インストールが
--accept-capabilitiesの unknown-option エラーで失敗する。 OpenClaw が 2026.8.1 より古いバージョンです。OpenClaw をアップグレードしてから、インストールをやり直してください。 - インストールが状態
disabledを報告する。openclaw plugins enable cc-safety-netを実行し、Gateway を再起動してください。 - インストールやアンインストールが実行を拒否する。
cc-safety-netの拡張機能ディレクトリに、CC Safety Net の管理対象プラグイン以外のものがあります。そのディレクトリを移動または削除してから、コマンドを再実行してください。