openclaw hooks

エージェントフック（/new、/reset、Gateway の起動などのコマンドに対するイベント駆動型自動化）を管理します。引数なしの openclaw hooks は openclaw hooks list と同等です。

関連項目: フック - Plugin フック

フックの一覧表示

openclaw hooks list [--eligible] [--json] [-v|--verbose]

ワークスペース、管理対象、追加、同梱の各ディレクトリから検出されたフックを一覧表示します。

• --eligible: 要件を満たすフックのみ。
• --json: 構造化出力。
• -v, --verbose: 満たされていない要件を示す「不足」列を含めます。

フック（4/5 が準備完了） 準備完了:  🚀 boot-md ✓ - Gateway の起動時に BOOT.md を実行  📎 bootstrap-extra-files ✓ - エージェントのブートストラップ中に追加のワークスペースブートストラップファイルを注入  📝 command-logger ✓ - すべてのコマンドイベントを一元化された監査ファイルに記録  💾 session-memory ✓ - /new または /reset コマンドの発行時にセッションコンテキストをメモリへ保存

フック情報の取得

openclaw hooks info <name> [--json]

<name> はフック名またはフックキー（例: session-memory）です。ソース、ファイル/ハンドラーのパス、ホームページ、イベント、および要件ごとの状態（バイナリ、環境変数、設定、OS）を表示します。

適格性の確認

openclaw hooks check [--json]

準備完了/未完了の件数概要を出力します。準備未完了のフックがある場合は、各フックとその阻害理由を一覧表示します。

フックの有効化

openclaw hooks enable <name>

設定の hooks.internal.entries.<name>.enabled = true を追加または更新し、hooks.internal.enabled マスタースイッチもオンにします（少なくとも1つが設定されるまで、Gateway は内部フックハンドラーを読み込みません）。フックが存在しない場合、Plugin によって管理されている場合、または要件不足により適格でない場合は失敗します。

Plugin 管理のフックは hooks list に plugin:<id> と表示され、ここでは有効化または無効化できません。代わりに、所有する Plugin を有効化または無効化してください。

有効化後は、フックを再読み込みするために Gateway を再起動してください（macOS メニューバーアプリを再起動するか、開発環境の Gateway プロセスを再起動します）。

フックの無効化

openclaw hooks disable <name>

hooks.internal.entries.<name>.enabled = false を設定します。その後、Gateway を再起動してください。

フックパックのインストールと更新

openclaw plugins install <package>        # デフォルトでは npmopenclaw plugins install npm:<package>    # npm のみopenclaw plugins install <package> --pin  # 解決されたバージョンを固定openclaw plugins install <path>           # ローカルディレクトリまたはアーカイブopenclaw plugins install -l <path>        # コピーせずにローカルディレクトリをリンク openclaw plugins update <id>openclaw plugins update --allopenclaw plugins update --dry-run

フックパックは統合された Plugin インストーラー/アップデーターを通じてインストールされます。openclaw hooks install / openclaw hooks update は、警告を出力して plugins コマンドへ転送する非推奨のエイリアスとして引き続き動作します。

• npm 指定はレジストリのみに対応します。パッケージ名に、任意で完全一致のバージョンまたは dist-tag を追加できます。Git/URL/ファイル指定および semver 範囲は拒否されます。依存関係のインストールはプロジェクトローカルで --ignore-scripts を指定して実行されます。
• バージョン指定なしおよび @latest は安定版トラックに留まります。npm がプレリリース版へ解決した場合、OpenClaw は停止し、明示的なオプトイン（@beta、@rc、または完全一致のプレリリースバージョン）を求めます。
• 対応アーカイブ: .zip、.tgz、.tar.gz、.tar。
• -l, --link は、ローカルディレクトリをコピーせずにリンクします（hooks.internal.load.extraDirs に追加します）。リンクされたフックパックは、ワークスペースフックではなく、オペレーターが設定したディレクトリにある管理対象フックです。
• --pin は、npm インストールを解決済みの完全一致 name@version として hooks.internal.installs に記録します。
• インストールでは、パックを ~/.openclaw/hooks/<id> にコピーし、hooks.internal.entries.* 配下のフックを有効化して、インストールを hooks.internal.installs に記録します。
• 保存済みの整合性ハッシュが取得したアーティファクトと一致しなくなった場合、OpenClaw は警告し、続行前に確認を求めます。プロンプトを省略するには、グローバルな --yes を指定します（CI での使用例など）。

同梱フック

同梱フックは openclaw hooks enable <hook-name> で有効化できます。詳細、設定キー、デフォルトについては、同梱フックを参照してください。

command-logger のログファイル

tail -n 20 ~/.openclaw/logs/commands.log        # 最近のコマンドcat ~/.openclaw/logs/commands.log | jq .          # 読みやすく整形して出力grep '"action":"new"' ~/.openclaw/logs/commands.log | jq .   # アクションで絞り込み

注記

• hooks list --json、info --json、check --json は、構造化された JSON を標準出力へ直接書き込みます。

関連項目

• CLI リファレンス
• 自動化フック