openclaw hooks

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

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

フックの一覧表示

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

ワークスペース、管理対象、追加、およびバンドル済みの各ディレクトリから検出されたフックを一覧表示します。

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

フック（準備完了: 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 として共有 SQLite 状態に記録します。
• インストール時にパックを ~/.openclaw/hooks/<id> にコピーし、そのフックを hooks.internal.entries.* で有効化して、インストール元情報を共有 SQLite 状態に記録します。
• 保存された整合性ハッシュが取得したアーティファクトと一致しなくなった場合、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 リファレンス
• オートメーションフック