openclaw hooks
管理代理程式鉤子（事件驅動的自動化，用於 /new、/reset 和閘道啟動等命令）。單獨執行 openclaw hooks 等同於 openclaw hooks list。
相關：鉤子 - 外掛鉤子
列出鉤子
--eligible：只列出符合需求的鉤子。--json：結構化輸出。-v, --verbose：包含顯示未滿足需求的 Missing 欄位。
取得鉤子資訊
<name> 是鉤子名稱或鉤子鍵（例如 session-memory）。顯示來源、檔案/處理器路徑、首頁、事件，以及每個需求的狀態（二進位檔、環境變數、設定、作業系統）。
檢查資格
啟用鉤子
hooks.internal.entries.<name>.enabled = true，並同時開啟 hooks.internal.enabled 主開關（在至少設定一個鉤子之前，閘道不會載入任何內部鉤子處理器）。如果鉤子不存在、由外掛管理，或不符合資格（缺少需求），則會失敗。
由外掛管理的鉤子會在 hooks list 中顯示 plugin:<id>，且無法在此啟用/停用；請改為啟用或停用其所屬外掛。
啟用後請重新啟動閘道（重新啟動 macOS 選單列應用程式，或在開發環境重新啟動你的閘道程序），使其重新載入鉤子。
停用鉤子
hooks.internal.entries.<name>.enabled = false。之後請重新啟動閘道。
安裝和更新鉤子套件
openclaw hooks install / openclaw hooks update 仍可作為已棄用的別名使用，會列印警告並轉送到 plugins 命令。
- Npm 規格僅限登錄檔：套件名稱加上選用的精確版本或 dist-tag。Git/URL/file 規格與 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 中）。
內建鉤子
| 鉤子 | 事件 | 功能 |
|---|---|---|
| boot-md | gateway:startup | 在每個已設定的代理程式範圍於閘道啟動時執行 BOOT.md |
| bootstrap-extra-files | agent:bootstrap | 在代理程式啟動期間注入額外的啟動檔案（例如 monorepo AGENTS.md/TOOLS.md） |
| command-logger | command | 將命令事件記錄到 ~/.openclaw/logs/commands.log |
| compaction-notifier | session:compact:before, session:compact:after | 在工作階段壓縮開始和完成時傳送可見的聊天通知 |
| session-memory | command:new, command:reset | 在 /new 或 /reset 時將工作階段脈絡儲存到記憶體 |
openclaw hooks enable <hook-name> 啟用任何內建鉤子。完整詳細資訊、設定鍵和預設值：內建鉤子。
command-logger 記錄檔
備註
hooks list --json、info --json和check --json會將結構化 JSON 直接寫入 stdout。