CLI commands
हुक्स
openclaw hooks
एजेंट हुक प्रबंधित करें (इवेंट-संचालित स्वचालन, जैसे /new, /reset, और Gateway स्टार्टअप जैसे कमांड के लिए)। केवल openclaw hooks देना openclaw hooks list के समतुल्य है।
संबंधित: हुक - Plugin हुक
हुक सूचीबद्ध करें
openclaw hooks list [--eligible] [--json] [-v|--verbose]वर्कस्पेस, प्रबंधित, अतिरिक्त और बंडल की गई डायरेक्टरियों से खोजे गए हुक सूचीबद्ध करता है।
--eligible: केवल वे हुक जिनकी आवश्यकताएँ पूरी होती हैं।--json: संरचित आउटपुट।-v, --verbose: पूरी न हुई आवश्यकताओं वाला Missing कॉलम शामिल करें।
हुक (4/5 तैयार) तैयार: 🚀 boot-md ✓ - Gateway स्टार्टअप पर BOOT.md चलाएँ 📎 bootstrap-extra-files ✓ - एजेंट बूटस्ट्रैप के दौरान अतिरिक्त वर्कस्पेस बूटस्ट्रैप फ़ाइलें प्रविष्ट करें 📝 command-logger ✓ - सभी कमांड इवेंट को एक केंद्रीकृत ऑडिट फ़ाइल में लॉग करें 💾 session-memory ✓ - /new या /reset कमांड जारी होने पर सेशन संदर्भ को मेमोरी में सहेजेंहुक की जानकारी प्राप्त करें
openclaw hooks info <name> [--json]<name> हुक का नाम या हुक कुंजी है (उदाहरण के लिए session-memory)। स्रोत, फ़ाइल/हैंडलर पथ, होमपेज, इवेंट और प्रत्येक आवश्यकता की स्थिति (बाइनरी, env, कॉन्फ़िगरेशन, OS) दिखाता है।
पात्रता जाँचें
openclaw hooks check [--json]तैयार/तैयार-नहीं संख्या का सारांश प्रिंट करता है; जो हुक तैयार नहीं हैं, उनमें से प्रत्येक को उसके अवरोधक कारण के साथ सूचीबद्ध करता है।
हुक सक्षम करें
openclaw hooks enable <name>कॉन्फ़िगरेशन में hooks.internal.entries.<name>.enabled = true जोड़ता/अपडेट करता है और hooks.internal.enabled मुख्य स्विच भी चालू करता है (कम-से-कम एक हुक कॉन्फ़िगर होने तक Gateway किसी आंतरिक हुक हैंडलर को लोड नहीं करता)। यदि हुक मौजूद नहीं है, Plugin द्वारा प्रबंधित है या पात्र नहीं है (आवश्यकताएँ अनुपलब्ध हैं), तो यह विफल हो जाता है।
Plugin द्वारा प्रबंधित हुक hooks list में plugin:<id> दिखाते हैं और उन्हें यहाँ सक्षम/अक्षम नहीं किया जा सकता; इसके बजाय स्वामी Plugin को सक्षम या अक्षम करें।
सक्षम करने के बाद Gateway को पुनः आरंभ करें (macOS मेनू बार ऐप पुनः आरंभ करें या डेवलपमेंट में अपनी Gateway प्रक्रिया पुनः आरंभ करें), ताकि वह हुक दोबारा लोड करे।
हुक अक्षम करें
openclaw hooks disable <name>hooks.internal.entries.<name>.enabled = false सेट करता है। इसके बाद Gateway को पुनः आरंभ करें।
हुक पैक इंस्टॉल और अपडेट करें
openclaw plugins install <package> # डिफ़ॉल्ट रूप से npmopenclaw plugins install npm:<package> # केवल npmopenclaw plugins install <package> --pin # निर्धारित संस्करण पिन करेंopenclaw plugins install <path> # स्थानीय डायरेक्टरी या आर्काइवopenclaw plugins install -l <path> # कॉपी करने के बजाय स्थानीय डायरेक्टरी लिंक करें openclaw plugins update <id>openclaw plugins update --allopenclaw plugins update --dry-runहुक पैक एकीकृत Plugin इंस्टॉलर/अपडेटर के माध्यम से इंस्टॉल होते हैं; 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में जोड़ता है); लिंक किए गए हुक पैक ऑपरेटर द्वारा कॉन्फ़िगर की गई डायरेक्टरी के प्रबंधित हुक होते हैं, वर्कस्पेस हुक नहीं।--pinnpm इंस्टॉलेशन को साझा SQLite स्थिति में सटीक निर्धारितname@versionके रूप में रिकॉर्ड करता है।- इंस्टॉलेशन पैक को
~/.openclaw/hooks/<id>में कॉपी करता है, उसके हुक कोhooks.internal.entries.*के अंतर्गत सक्षम करता है और इंस्टॉलेशन उद्गम को साझा SQLite स्थिति में रिकॉर्ड करता है। - यदि संग्रहीत अखंडता हैश अब प्राप्त आर्टिफ़ैक्ट से मेल नहीं खाता, तो OpenClaw चेतावनी देता है और आगे बढ़ने से पहले संकेत देता है; संकेत को छोड़ने के लिए वैश्विक
--yesपास करें (उदाहरण के लिए CI में)।
बंडल किए गए हुक
| हुक | इवेंट | इसका कार्य |
|---|---|---|
| boot-md | gateway:startup |
प्रत्येक कॉन्फ़िगर किए गए एजेंट दायरे के लिए Gateway स्टार्टअप पर BOOT.md चलाता है |
| bootstrap-extra-files | agent:bootstrap |
एजेंट बूटस्ट्रैप के दौरान अतिरिक्त बूटस्ट्रैप फ़ाइलें (उदाहरण के लिए मोनोरेपो AGENTS.md/TOOLS.md) प्रविष्ट करता है |
| command-logger | command |
कमांड इवेंट को ~/.openclaw/logs/commands.log में लॉग करता है |
| compaction-notifier | session:compact:before, session:compact:after |
सेशन Compaction शुरू और पूरा होने पर दृश्यमान चैट सूचनाएँ भेजता है |
| session-memory | command:new, command:reset |
/new या /reset पर सेशन संदर्भ को मेमोरी में सहेजता है |
किसी भी बंडल किए गए हुक को openclaw hooks enable <hook-name> से सक्षम करें। पूर्ण विवरण, कॉन्फ़िगरेशन कुंजियाँ और डिफ़ॉल्ट: बंडल किए गए हुक।
command-logger लॉग फ़ाइल
tail -n 20 ~/.openclaw/logs/commands.log # हाल के कमांडcat ~/.openclaw/logs/commands.log | jq . # सुव्यवस्थित प्रिंटgrep '"action":"new"' ~/.openclaw/logs/commands.log | jq . # कार्रवाई के अनुसार फ़िल्टर करेंटिप्पणियाँ
hooks list --json,info --json, औरcheck --jsonसंरचित JSON को सीधे stdout पर लिखते हैं।