フック

エージェントフック（''/new''、''/reset''、ゲートウェイ起動などのイベント駆動型自動化コマンド）を管理します。

Related:

- フック：''フック''

- プラグインフック：''プラグイン''

openclaw hooks list

ワークスペース、ホストされたディレクトリ、バンドルされたディレクトリから発見されたすべてのフックを一覧表示します。

オプション：

- ''--eligible''：条件を満たすフックのみを表示

- ''--json''：JSON として出力

- ''-v, --verbose''：欠落している要件を含む詳細を表示

Output example:

Example (verbose):

Hooks (4/4 ready)

Ready:
  🚀 boot-md ✓ - Run BOOT.md on gateway startup
  📝 command-logger ✓ - Log all command events to a centralized audit file
  💾 session-memory ✓ - Save session context to memory when /new command is issued
  😈 soul-evil ✓ - Swap injected SOUL content during a purge window or by random chance

条件を満たさないフックの欠落している要件を表示します。

openclaw hooks list --verbose

Example (JSON):

プログラムでの使用のために構造化された JSON を返します。

openclaw hooks list --json

ReferenceCliHooksPage step 01: P11

openclaw hooks info <name>

特定のフックに関する詳細情報を表示します。

Arguments:

- ''<name>'': Hook name (e.g., ''session-memory'')

オプション：

- ''--json''：JSON として出力

openclaw hooks info session-memory

Example:

💾 session-memory ✓ Ready

Save session context to memory when /new command is issued

Details:
  Source: openclaw-bundled
  Path: /path/to/openclaw/hooks/bundled/session-memory/HOOK.md
  Handler: /path/to/openclaw/hooks/bundled/session-memory/handler.ts
  Homepage: https://docs.openclaw.ai/hooks#session-memory
  Events: command:new

Requirements:
  Config: ✓ workspace.dir

openclaw hooks check

フックの適格性ステータスの概要（準備完了と未完了の数）を表示します。

オプション：

- ''--json''：JSON として出力

Hooks Status

Total hooks: 4
Ready: 4
Not ready: 0

openclaw hooks enable <name>

特定のフックを設定 (''~/.openclaw/config.json'') に追加して有効にします。

''Note:'' Hooks managed by plugins show ''plugin:<id>'' in ''openclaw hooks list'' and

ここで有効化/無効化できません。代わりに、プラグインを有効化/無効化してください。

Arguments:

- ''<name>'': Hook name (e.g., ''session-memory'')

openclaw hooks enable session-memory

Example:

✓ Enabled hook: 💾 session-memory

Output:

What it does:

- フックが存在し、条件を満たしているかを確認

- Updates ''hooks.internal.entries.<name>.enabled = true'' in your configuration

- 設定をディスクに保存

After enabling:

openclaw hooks disable <name>

設定を更新して特定のフックを無効にします。

Arguments:

- ''<name>'': Hook name (e.g., ''command-logger'')

openclaw hooks disable command-logger

Example:

⏸ Disabled hook: 📝 command-logger

Output:

After disabling:

openclaw hooks install <path-or-spec>

ローカルフォルダ/アーカイブまたは npm からフックパッケージをインストールします。

What it does:

- Copies hook package to ''~/.openclaw/hooks/<id>''

- ''hooks.internal.entries.*'' でインストールされたフックを有効化

- ''hooks.internal.installs'' の下にインストールを記録

オプション：

- ''-l, --link''：コピーの代わりにローカルディレクトリをリンク（''hooks.internal.load.extraDirs'' に追加）

''サポートされるアーカイブ：'' ''.zip''、''.tgz''、''.tar.gz''、''.tar''

openclaw hooks install ./my-hook-pack


openclaw hooks install ./my-hook-pack.zip


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''：書き込まずに変更内容を表示

#

''/new'' を発行したときに、セッションコンテキストをメモリに保存します。

Enable:

openclaw hooks enable session-memory

Output: ~/.openclaw/workspace/memory/YYYY-MM-DD-slug.md

See: セッションメモリドキュメント

#

すべてのコマンドイベントを集中監査ファイルに記録します。

Enable:

openclaw hooks enable command-logger

Output: ~/.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 .

See: コマンドロガードキュメント

### Soul evil

パージウィンドウ中またはランダムに、注入された ''SOUL.md'' コンテンツを ''SOUL_EVIL.md'' と交換します。

openclaw hooks enable soul-evil

See: ソウルイビルフックドキュメント

#

ゲートウェイ起動時（チャンネル起動後）に ''BOOT.md'' を実行します。

イベント： gateway:startup

Enable:

openclaw hooks enable boot-md

See: boot-md ドキュメント