CLI コマンド
hooks
エージェントフック（/new、/reset、ゲートウェイ起動などのコマンドに対するイベント駆動型自動化）を管理します。関連項目:
すべてのフックを一覧表示
openclaw hooks list
ワークスペース、管理対象、バンドル済みディレクトリから発見されたすべてのフックを一覧表示します。オプション:
--eligible: 適格なフックのみを表示（要件を満たしているもの）--json: JSON形式で出力-v, --verbose: 不足している要件を含む詳細情報を表示
出力例:
フック (4/4 準備完了)
準備完了:
🚀 boot-md ✓ - ゲートウェイ起動時に BOOT.md を実行
📎 bootstrap-extra-files ✓ - エージェントブートストラップ中に追加のワークスペースブートストラップファイルを注入
📝 command-logger ✓ - すべてのコマンドイベントを一元化された監査ファイルに記録
💾 session-memory ✓ - /new コマンド発行時にセッションコンテキストをメモリ に保存
例 (詳細):
openclaw hooks list --verbose
適格でないフックの不足要件を表示します。例 (JSON):
openclaw hooks list --json
プログラムで使用するための構造化されたJSONを返します。
フック情報を取得
openclaw hooks info <name>
特定のフックに関する詳細情報を表示 します。引数:
- ``: フック名 (例:
session-memory)
オプション:
--json: JSON形式で出力
例:
openclaw hooks info session-memory
出力:
💾 session-memory ✓ 準備完了
/new コマンド発行時にセッションコンテキストをメモリに保存
詳細:
ソース: openclaw-bundled
パス: /path/to/openclaw/hooks/bundled/session-memory/HOOK.md
ハンドラー: /path/to/openclaw/hooks/bundled/session-memory/handler.ts
ホームページ: https://docs.openclaw.ai/automation/hooks#session-memory
イベント: command:new
要件:
設定: ✓ workspace.dir
フックの適格性を確認
openclaw hooks check
フックの適格性ステータス（準備完了数 vs 未完了数）の概要を表示します。オプション:
--json: JSON形式で出力
出力例:
フックステータス
総フック数: 4
準備完了: 4
未完了: 0
フックを有効化
openclaw hooks enable <name>
特定のフックを有効化し、設定（~/.openclaw/config.json）に追加します。注: プラグインによって管理されるフックは openclaw hooks list で plugin: と表示され、ここでは有効化/無効化できません。代わりにプラグイン自体を有効化/無効化してください。引数:
- ``: フック名 (例:
session-memory)
例:
openclaw hooks enable session-memory
出力:
✓ フックを有効化しました: 💾 session-memory
動作内容:
- フックが存在し、適格であるかを確認
- 設定内の
hooks.internal.entries..enabled = trueを更新 - 設定をディスクに保存
有効化後:
- フックを再読み込みするためにゲートウェイを再起動してください（macOSではメニューバーアプリの再起動、開発中であればゲートウェイプロセスの再起動）。
フックを無効化
openclaw hooks disable <name>
特定のフックを無効化し、設定を更新します。引数:
- ``: フック名 (例:
command-logger)
例:
openclaw hooks disable command-logger
出力:
⏸ フックを無効化しました: 📝 command-logger
無効化後:
- フックを再読み込みするためにゲートウェイを再起動してください
フックをインストール
openclaw hooks install <path-or-spec>
openclaw hooks install <npm-spec> --pin
ローカルフォルダー/アーカイブまたはnpmからフックパックをインストールします。Npm仕様はレジストリのみ（パッケージ名 + オプションの正確なバージョンまたはディストタグ）です。Git/URL/ファイル仕様とセマバー範囲は拒否されます。依存関係のインストールは安全性のため --ignore-scripts で実行されます。ベア仕様と @latest は安定版トラックに留まります。npmがこれらのいずれかをプレリリースに解決した場合、OpenClawは停止し、@beta/@rc などのプレリリースタグまたは正確なプレリリースバージョンを明示的に指定してオプトインするよう求めます。動作内容:
- フックパックを
~/.openclaw/hooks/にコピー - インストールされたフックを
hooks.internal.entries.*で有効化 - インストールを
hooks.internal.installsに記録
オプション:
-l, --link: コピーせずにローカルディレクトリをリンク（hooks.internal.load.extraDirsに追加）--pin: npmインストールを正確な解決済みname@versionとしてhooks.internal.installsに記録
サポート されるアーカイブ: .zip, .tgz, .tar.gz, .tar 例:
# ローカルディレクトリ
openclaw hooks install ./my-hook-pack
# ローカルアーカイブ
openclaw hooks install ./my-hook-pack.zip
# NPMパッケージ
openclaw hooks install @openclaw/my-hook-pack
# コピーせずにローカルディレクトリをリンク
openclaw hooks install -l ./my-hook-pack
フックを更新
openclaw hooks update <id>
openclaw hooks update --all
インストール済みのフックパック（npmインストールのみ）を更新します。オプション:
--all: 追跡中のすべてのフックパックを更新--dry-run: 書き込みを行わずに変更内容を表示
保存された整合性ハッシュが存在し、取得したアーティファクトのハッシュが変更された場合、OpenClawは警告を表示し、続行前に確認を求めます。CI/非対話型実行でプロンプトをバイパスするには、グローバルオプション --yes を使用してください。
バンドル済みフック
session-memory
/new コマンドを発行したときにセッションコンテキストをメモリ に保存します。有効化:
openclaw hooks enable session-memory
出力: ~/.openclaw/workspace/memory/YYYY-MM-DD-slug.md 参照: session-memory ドキュメント
bootstrap-extra-files
agent:bootstrap 中に追加のブートストラップファイル（例: モノレポローカルの AGENTS.md / TOOLS.md）を注入します。有効化:
openclaw hooks enable bootstrap-extra-files
参照: bootstrap-extra-files ドキュメント
command-logger
すべてのコマンドイベントを一元化された監査ファイルに記録します。有効化:
openclaw hooks enable command-logger
出力: ~/.openclaw/logs/commands.log ログを表示:
# 最近のコマンド
tail -n 20 ~/.openclaw/logs/commands.log
# 整形表示
cat ~/.openclaw/logs/commands.log | jq .
# アクションでフィルタ
grep '"action":"new"' ~/.openclaw/logs/commands.log | jq .
boot-md
ゲートウェイ起動時（チャネル起動後）に BOOT.md を実行します。イベント: gateway:startup 有効化:
openclaw hooks enable boot-md
参照: boot-md ドキュメント