openclaw hooks
エージェントフック（/new、/reset、Gateway の起動などのコマンドに対するイベント駆動型オートメーション）を管理します。単独の openclaw hooks は openclaw hooks list と同等です。
関連項目: フック - Plugin フック
フックの一覧表示
--eligible: 要件を満たすフックのみ。--json: 構造化された出力。-v, --verbose: 満たされていない要件を示す Missing 列を含めます。
フック情報の取得
<name> はフック名またはフックキーです（例: session-memory）。ソース、ファイル/ハンドラーのパス、ホームページ、イベント、および要件ごとの状態（バイナリ、環境変数、設定、OS）を表示します。
適格性の確認
フックの有効化
hooks.internal.entries.<name>.enabled = true を追加または更新し、hooks.internal.enabled マスタースイッチもオンにします（少なくとも 1 つ設定されるまで、Gateway は内部フックハンドラーを読み込みません）。フックが存在しない場合、Plugin によって管理されている場合、または適格でない場合（要件不足）は失敗します。
Plugin によって管理されるフックは hooks list に plugin:<id> と表示され、ここでは有効化または無効化できません。代わりに、そのフックを所有する Plugin を有効化または無効化してください。
有効化後は、フックを再読み込みするために Gateway を再起動してください（macOS メニューバーアプリの再起動、または開発環境で Gateway プロセスを再起動）。
フックの無効化
hooks.internal.entries.<name>.enabled = false を設定します。その後、Gateway を再起動してください。
フックパックのインストールと更新
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 のログファイル
注記
hooks list --json、info --json、およびcheck --jsonは、構造化された JSON を標準出力に直接書き込みます。