मुख्य सामग्री पर जाएं

​
openclaw hooks

एजेंट hooks प्रबंधित करें (/new, /reset, और gateway startup जैसे कमांड के लिए event-driven automation). बिना subcommand के openclaw hooks चलाना openclaw hooks list के बराबर है। संबंधित:

​
सभी hooks सूचीबद्ध करें

openclaw hooks list
workspace, managed, extra, और bundled directories से खोजे गए सभी hooks सूचीबद्ध करें। Gateway startup आंतरिक hook handlers को तब तक लोड नहीं करता जब तक कम से कम एक आंतरिक hook कॉन्फ़िगर न हो। विकल्प:
  • --eligible: केवल eligible hooks दिखाएं (requirements पूरी)
  • --json: JSON के रूप में output दें
  • -v, --verbose: missing requirements सहित विस्तृत जानकारी दिखाएं
उदाहरण output: 
Hooks (4/4 ready)

Ready:
  🚀 boot-md ✓ - Run BOOT.md on gateway startup
  📎 bootstrap-extra-files ✓ - Inject extra workspace bootstrap files during agent bootstrap
  📝 command-logger ✓ - Log all command events to a centralized audit file
  💾 session-memory ✓ - Save session context to memory when /new or /reset command is issued
उदाहरण (verbose): 
openclaw hooks list --verbose
ineligible hooks के लिए missing requirements दिखाता है। उदाहरण (JSON): 
openclaw hooks list --json
programmatic उपयोग के लिए structured JSON लौटाता है।

​
Hook जानकारी प्राप्त करें

openclaw hooks info <name>
किसी विशिष्ट hook के बारे में विस्तृत जानकारी दिखाएं। Arguments:
  • <name>: Hook name या hook key (उदा., session-memory)
विकल्प:
  • --json: JSON के रूप में output दें
उदाहरण: 
openclaw hooks info session-memory
Output: 
💾 session-memory ✓ Ready

Save session context to memory when /new or /reset 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/automation/hooks#session-memory
  Events: command:new, command:reset

Requirements:
  Config: ✓ workspace.dir

​
Hooks eligibility जांचें

openclaw hooks check
hook eligibility status का सारांश दिखाएं (कितने ready हैं बनाम not ready). विकल्प:
  • --json: JSON के रूप में output दें
उदाहरण output: 
Hooks Status

Total hooks: 4
Ready: 4
Not ready: 0

​
Hook सक्षम करें

openclaw hooks enable <name>
किसी विशिष्ट hook को अपने config में जोड़कर सक्षम करें (default रूप से ~/.openclaw/openclaw.json). नोट: Workspace hooks default रूप से disabled रहते हैं जब तक यहां या config में enabled न किए जाएं। plugins द्वारा managed hooks openclaw hooks list में plugin:<id> दिखाते हैं और यहां enabled/disabled नहीं किए जा सकते। इसके बजाय plugin को enable/disable करें। Arguments:
  • <name>: Hook name (उदा., session-memory)
उदाहरण: 
openclaw hooks enable session-memory
Output: 
✓ Enabled hook: 💾 session-memory
यह क्या करता है:
  • जांचता है कि hook मौजूद है और eligible है
  • आपके config में hooks.internal.entries.<name>.enabled = true अपडेट करता है
  • config को disk पर सहेजता है
यदि hook <workspace>/hooks/ से आया है, तो Gateway द्वारा उसे लोड करने से पहले यह opt-in step आवश्यक है। सक्षम करने के बाद:
  • gateway restart करें ताकि hooks reload हों (macOS पर menu bar app restart, या dev में अपना gateway process restart करें).

​
Hook अक्षम करें

openclaw hooks disable <name>
अपने config को अपडेट करके किसी विशिष्ट hook को अक्षम करें। Arguments:
  • <name>: Hook name (उदा., command-logger)
उदाहरण: 
openclaw hooks disable command-logger
Output: 
⏸ Disabled hook: 📝 command-logger
अक्षम करने के बाद:
  • gateway restart करें ताकि hooks reload हों

​
नोट्स

  • openclaw hooks list --json, info --json, और check --json structured JSON को सीधे stdout पर लिखते हैं।
  • Plugin-managed hooks यहां enabled या disabled नहीं किए जा सकते; इसके बजाय owning plugin को enable या disable करें।

​
Hook packs install करें

openclaw plugins install <package>        # npm by default
openclaw plugins install npm:<package>    # npm only
openclaw plugins install <package> --pin  # pin version
openclaw plugins install <path>           # local path
unified plugins installer के माध्यम से hook packs install करें। openclaw hooks install अब भी compatibility alias के रूप में काम करता है, लेकिन यह deprecation warning print करता है और openclaw plugins install को forward करता है। Npm specs केवल registry हैं (package name + optional exact version या dist-tag). Git/URL/file specs और semver ranges अस्वीकार किए जाते हैं। Dependency installs सुरक्षा के लिए --ignore-scripts के साथ project-local चलते हैं, तब भी जब आपके shell में global npm install settings हों। Bare specs और @latest stable track पर रहते हैं। यदि npm इनमें से किसी को prerelease पर resolve करता है, तो OpenClaw रुकता है और आपसे @beta/@rc जैसे prerelease tag या exact prerelease version के साथ स्पष्ट opt in करने को कहता है। यह क्या करता है:
  • hook pack को ~/.openclaw/hooks/<id> में copy करता है
  • installed hooks को hooks.internal.entries.* में enable करता है
  • install को hooks.internal.installs के अंतर्गत record करता है
विकल्प:
  • -l, --link: copy करने के बजाय local directory link करें (इसे hooks.internal.load.extraDirs में जोड़ता है)
  • --pin: npm installs को hooks.internal.installs में exact resolved name@version के रूप में record करें
Supported archives: .zip, .tgz, .tar.gz, .tar उदाहरण: 
# Local directory
openclaw plugins install ./my-hook-pack

# Local archive
openclaw plugins install ./my-hook-pack.zip

# NPM package
openclaw plugins install @openclaw/my-hook-pack

# Link a local directory without copying
openclaw plugins install -l ./my-hook-pack
Linked hook packs को operator-configured directory से managed hooks माना जाता है, workspace hooks नहीं।

​
Hook packs update करें

openclaw plugins update <id>
openclaw plugins update --all
unified plugins updater के माध्यम से tracked npm-based hook packs update करें। openclaw hooks update अब भी compatibility alias के रूप में काम करता है, लेकिन यह deprecation warning print करता है और openclaw plugins update को forward करता है। विकल्प:
  • --all: सभी tracked hook packs update करें
  • --dry-run: लिखे बिना दिखाएं कि क्या बदलेगा
जब stored integrity hash मौजूद हो और fetched artifact hash बदल जाए, OpenClaw warning print करता है और आगे बढ़ने से पहले confirmation मांगता है। CI/non-interactive runs में prompts bypass करने के लिए global --yes का उपयोग करें।

​
Bundled hooks

​
session-memory

जब आप /new या /reset issue करते हैं तो session context को memory में सहेजता है। सक्षम करें: 
openclaw hooks enable session-memory
Output: default रूप से ~/.openclaw/workspace/memory/YYYY-MM-DD-HHMM.md. model-generated filename slugs के लिए hooks.internal.entries.session-memory.llmSlug: true सेट करें। देखें: session-memory documentation

​
bootstrap-extra-files

agent:bootstrap के दौरान अतिरिक्त bootstrap files (उदाहरण के लिए monorepo-local AGENTS.md / TOOLS.md) inject करता है। सक्षम करें: 
openclaw hooks enable bootstrap-extra-files
देखें: bootstrap-extra-files documentation

​
command-logger

सभी command events को centralized audit file में log करता है। सक्षम करें: 
openclaw hooks enable command-logger
Output: ~/.openclaw/logs/commands.log Logs देखें: 
# Recent commands
tail -n 20 ~/.openclaw/logs/commands.log

# Pretty-print
cat ~/.openclaw/logs/commands.log | jq .

# Filter by action
grep '"action":"new"' ~/.openclaw/logs/commands.log | jq .
देखें: command-logger documentation

​
boot-md

gateway शुरू होने पर BOOT.md चलाता है (channels शुरू होने के बाद). Events: gateway:startup सक्षम करें: 
openclaw hooks enable boot-md
देखें: boot-md documentation

​
संबंधित