Claw से कोड लिखवाना: exec, पैच और अप्रूवल
💡 एक वाक्य में सारांश: OpenClaw से कोड लिखवाकर «कमांड चलने लायक, पैच समीक्षा योग्य, लागू करने में मानव-निगरानी» वाला लोकल कोडिंग वर्कफ़्लो बनाएँ — exec कमांड चलाता है, apply_patch पैच बनाता है, और अप्रूवल पॉलिसी सीमाएँ बनाए रखती है।
सीखने के बाद आप क्या कर सकेंगे
- Claw को अपने वर्कस्पेस में वास्तव में
npm testजैसी कमांड चलाने दें और विफलता के कारण समझें। - Claw को
apply_patchसे एक बार में कई फ़ाइलें और कई कोड सेगमेंट बदलवाने दें, ताकि स्ट्रक्चर्ड पैच बने। tools.exec.modeअप्रूवल पॉलिसी कॉन्फ़िगर करें, ताकि हाई-रिस्क कमांड एक-एक करके पुष्टि के बाद ही चलें।- ज़रूरत पड़ने पर Code Mode सक्रिय करें, ताकि मॉडल खोजने और टूल कॉल करने के लिए छोटे JavaScript प्रोग्राम लिखे।
वेब-आधारित AI के बजाय OpenClaw का उपयोग क्यों करें?
| क्षमता | वेब-आधारित AI | OpenClaw |
|---|---|---|
| कमांड चलाना | ❌ केवल सुझाव दे सकता है, आप खुद कॉपी-पेस्ट करें | ✅ exec चुने गए होस्ट या सैंडबॉक्स फ़ाइल सिस्टम की अनुमति सीमा में चलाता है |
| मल्टी-फ़ाइल बदलाव | ❌ एक बार में एक फ़ाइल पेस्ट करनी पड़ती है, छूटने की संभावना रहती है | ✅ apply_patch एक ही पैच में जोड़ना, बदलना, हटाना, मिटाना शामिल |
| सुरक्षा निगरानी | ❌ कोई लोकल पॉलिसी नहीं | ✅ policy + allowlist + वैकल्पिक यूज़र अप्रूवल, तीन स्तरों पर निगरानी |
| सेल्फ-होस्टिंग | ❌ कोड दूसरों के सर्वर पर अपलोड करना पड़ता है | ✅ Gateway आपकी मशीन पर चलता है, कमांड लोकल वर्कस्पेस में ही रहते हैं |
आपकी मौजूदा दुविधा
- AI से कोड बदलवाने पर हर बार «कोड पेस्ट करना → वापस एडिटर में कॉपी करना → मैन्युअली टेस्ट चलाना» — बार-बार आवागमन।
- AI दिए गए बदलाव कई बातचीतों में बिखरे रहते हैं; आप नहीं जानते कि उसने वास्तव में कौन-कौन सी फ़ाइलें बदली हैं।
- AI को सीधे कमांड चलाना चाहते हैं, पर डरते हैं कि वह ऐसा कुछ न चला दे जो नहीं चलाना चाहिए।
इस तरकीब का उपयोग कब करें
- एक bug ठीक करने के लिए सोर्स कोड बदलना, टेस्ट जोड़ना और एक बार सत्यापन चलाना — सब एक साथ करना हो।
- रिफ़ैक्टरिंग में कई फ़ाइलों का स्थानांतरण या नाम बदलना शामिल हो।
- आप चाहते हैं कि «कमांड चलाना» और «फ़ाइलें बदलना» दोनों आपकी ही मशीन पर हों, और हर कदम समीक्षा योग्य हो।
🎒 शुरू करने से पहले की तैयारी
- Gateway आपकी मशीन पर चल रहा है, मॉडल provider जुड़ चुका है (Node 24.16.0+ या 26.1.0+)।
- वर्कस्पेस की सीमा सोच-समझकर तय करें:
execचुने गए होस्ट या सैंडबॉक्स फ़ाइल सिस्टम की अनुमति सीमा में चलता है, कमांड फ़ाइलें बना, संपादित और हटा सकते हैं। - अप्रूवल का स्तर तय करें: OpenClaw 2.0 का अप्रूवल सटीक रिक्वेस्ट, कमांड, सेशन और व्यक्ति से बंधा होता है; जो मंज़ूर होता है वह «इस बार की यह कमांड» है, पूरे टूल को छूट नहीं।
मेरे साथ करें
चरण 1: exec से कमांड चलाना
क्यों: पहले Claw को कमांड चलाने दें, तभी आगे कोड बदलने और सत्यापन की नींव बनेगी।
Claw से सीधे कहें:
वर्कस्पेस में npm test चलाओ, और विफल टेस्ट के नाम व एरर संदेश सुव्यवस्थित करके मुझे दो।आपको यह दिखना चाहिए: फ़ोरग्राउंड कमांड पूरा होने पर आउटपुट सीधे लौट आता है। केवल जब exec बताए कि कमांड अभी भी चल रही है और sessionId दे, तभी process से नियंत्रण लें — कमांड द्वारा खुद प्रिंट किया गया ID केवल सामान्य आउटपुट है, प्रोसेस हैंडल नहीं। कमांड विफल होने पर message फ़ील्ड में संक्षिप्त डायग्नोसिस होता है, जो aggregated के कमांड आउटपुट से अलग होता है।
चरण 2: पैच बनाकर लागू करना
क्यों: स्ट्रक्चर्ड पैच «स्ट्रिंग जोड़कर फ़ाइल फिर से लिखने» से अधिक केंद्रित और समीक्षा योग्य है, और एक बार में कई फ़ाइलों को कवर करता है।
Claw से कहें:
apply_patch से अभी विफल हुए टेस्ट ठीक करो: src/index.ts में foo को 1 से 2 बदलो,
और tests/foo.test.ts में एक assertion जोड़ो।आपको यह दिखना चाहिए: Claw apply_patch को कॉल करता है, जो एकमात्र अनिवार्य input पैरामीटर लेता है; पैच का फ़ॉर्मैट इस प्रकार है:
*** Begin Patch
*** Add File: path/to/file.txt
+line 1
+line 2
*** Update File: src/app.ts
@@
-old line
+new line
*** Update File: src/old-name.ts
*** Move to: src/new-name.ts
*** End of File
*** Delete File: obsolete.txt
*** End Patchइसके संगत JSON कॉल इस तरह दिखती है:
{
"tool": "apply_patch",
"input": "*** Begin Patch\n*** Update File: src/index.ts\n@@\n-const foo = 1\n+const foo = 2\n*** End Patch"
}*** Move to: संबंधित *** Update File: हेडर की अगली पंक्ति में लिखा जाता है; *** End of File इस hunk को फ़ाइल के अंत तक विस्तारित बताता है। पैच पाथ relative पाथ (workspace डायरेक्टरी के सापेक्ष) और absolute पाथ दोनों सपोर्ट करते हैं।
💡 यही OpenClaw का अनूठा मूल्य है
apply_patch, exec का sub-tool है और डिफ़ॉल्ट रूप से सक्षम है। tools.exec.applyPatch.workspaceOnly का डिफ़ॉल्ट false है; इसे true सेट करने पर पैच workspace तक सीमित हो जाता है; tools.exec.applyPatch.allowModels से आप तय कर सकते हैं कि कौन-से मॉडल इसे इस्तेमाल कर सकते हैं। ध्यान दें: tools.exec.mode को "full" सेट करने से यह workspace सीमा हटती नहीं है।
चरण 3: अप्रूवल के बाद ही अपलाई करें
क्यों: कमांड वास्तव में आपकी मशीन बदलने वाली होती है, इस चरण की जाँच इंसान करता है।
हाई-रिस्क कमांड चलने से पहले अप्रूवल से गुज़रती हैं: exec अप्रूवल की तीन परतें हैं — policy + allowlist + (वैकल्पिक) यूज़र अप्रूवल; कमांड तभी चलती है जब तीनों सहमत हों। पैच राइट इस अप्रूवल पैनल से नहीं गुज़रता, बल्कि tool policy, workspaceOnly और सेशन permission मोड से नियंत्रित होता है (full प्रतिबंध हटाता है, guarded/workspace कसता है, read-only इस टूल को ही नहीं देता)।
आपको यह दिखना चाहिए: अप्रूवल पैनल पर Allow Once (या Command-Return दबाने) से सिर्फ़ इस एक बार के निष्पादन की अनुमति मिलती है; Always Allow Here सिर्फ़ तब दिखता है जब policy persistent अप्रूवल की अनुमति देती हो, पुष्टि करने पर सटीक कमांड आर्ग्युमेंट और अप्रूवल के समय की working डायरेक्टरी से बंधा persistent allow नियम सेव होता है।
चरण 4: अप्रूवल policy कॉन्फ़िगर करें
क्यों: डिफ़ॉल्ट policy ज़रूरी नहीं कि आपके मापदंड से मेल खाए, इसे कॉन्फ़िगरेशन फ़ील्ड से तय कर लें।
कॉन्फ़िगरेशन में tools.exec.mode से मुख्य policy तय करें:
| मान | व्यवहार |
|---|---|
deny | host exec को रोकता है |
allowlist | सिर्फ़ allowlist वाली कमांड चलाता है, पूछता नहीं |
ask | allowlist policy + मिस होने पर पूछता है |
auto | हिट होने पर सीधे चलाता है; मिस होने पर allow (एक बार), deny (कारण agent को लौटाता है) या ask (मैनुअल अप्रूवल) |
full | सामान्य policy प्रॉम्प्ट से नहीं गुज़रता |
साथ के फ़ील्ड: exec.ask (off/on-miss/always, डिफ़ॉल्ट off), askFallback (UI पहुँच न होने या टाइमआउट पर fallback, डिफ़ॉल्ट deny), tools.exec.strictInlineEval (python -c, node -e जैसे inline evaluation रूपों को अप्रूवल-आवश्यक मानता है), tools.exec.commandHighlighting (सिर्फ़ अप्रूवल पैनल की हाइलाइटिंग पर असर डालता है)।
आपको यह दिखना चाहिए: कॉन्फ़िगरेशन बदलने के बाद प्रभावी policy tools.exec.* और approvals डिफ़ॉल्ट में सेज़्यादा सख़्त वाली ली जाती है — approvals सिर्फ़ कसती है, कॉन्फ़िगरेशन से निकली policy को ढीला नहीं करती।
चरण 5: ज़रूरत पड़ने पर Code Mode सक्षम करें
क्यों: टूल बढ़ने पर मॉडल के सामने schema भी बढ़ जाते हैं; Code Mode उसे छोटे JavaScript प्रोग्राम लिखकर टूल कैटलॉग खोजने, बताने और कॉल करने देता है।
सक्षम करने का तरीका: tools.codeMode डिफ़ॉल्ट रूप से "auto" मोड पर चलता है और सिर्फ़ Code Mode के लिए प्रेफ़र्ड मार्क किए गए मॉडल पर लागू होता है; Settings → Agents & Tools → Labs → Code Mode से ग्लोबल सेटिंग चुनें, या global / agent / model तीन स्तरों से override सक्रिय करें।
आपको यह दिखना चाहिए: सक्षम होने पर मॉडल को सिर्फ़ exec, wait जैसे कुछ ही टूल दिखते हैं; exec JSON { code } पेलोड स्वीकार करता है — ध्यान दें कि यहाँ command, code का JavaScript alias है, shell कमांड नहीं।
📋 मैजिक Prompt
🔧 टेस्ट चलाएँ और ठीक करें
अपेक्षित परिणाम: Claw पहले टेस्ट चलाकर फ़ेलियर का पता लगाता है, फिर पैच से ठीक करता है, पूरे दौरान workspace से बाहर के पाथ को नहीं छूता।
भूमिका: लोकल कोडिंग असिस्टेंट
कार्य: workspace में npm test चलाएँ, फ़ेल हुए टेस्ट ढूँढें, apply_patch से सोर्स कोड या टेस्ट ठीक करें
इनपुट जानकारी:
### आवश्यक फ़ील्ड ###
【फ़ेल हुए टेस्ट की एरर जानकारी】
### वैकल्पिक फ़ील्ड ###
【न बदलने वाली फ़ाइलों की सूची?】
आउटपुट स्पेसिफ़िकेशन: पहले फ़ेलियर का कारण एक वाक्य में, फिर पैच की सामग्री, अंत में टेस्ट दोबारा चलाकर परिणाम पेस्ट करें
प्रतिबंध:
✅ फ़ाइलें बदलने के लिए सिर्फ़ apply_patch इस्तेमाल करें
✅ पैच पाथ 【workspace डायरेक्टरी】 के भीतर रखें
❌ पूरी फ़ाइल rewrite करने के लिए exec का इस्तेमाल न करें
❌ workspace से बाहर किसी भी पाथ को न बदलें🚀 रिफ़ैक्टर मूव
अपेक्षित परिणाम: एक ही पैच में rename और रेफ़रेंस अपडेट पूरे।
भूमिका: रिफ़ैक्टरिंग असिस्टेंट
कार्य: src/old-name.ts को src/new-name.ts में rename करें और सभी रेफ़रेंस अपडेट करें
इनपुट जानकारी:
### आवश्यक फ़ील्ड ###
【पुराना फ़ाइल पाथ】【नया फ़ाइल पाथ】
### वैकल्पिक फ़ील्ड ###
【साथ अपडेट करने वाली डायरेक्टरी की सीमा?】
आउटपुट स्पेसिफ़िकेशन: एक apply_patch पैच, Move to से rename पूरा करें
प्रतिबंध:
✅ rename और रेफ़रेंस अपडेट एक ही पैच में रखें
✅ बदलने के बाद एक बार build चलाकर सत्यापित करें
❌ पुरानी फ़ाइल न छोड़ें
❌ असंबंधित फ़ाइलें न बदलेंचेकपॉइंट ✅
- कमांड वास्तव में पूरी हुई? headless node होस्ट पर सिस्टम सिग्नल से ख़त्म की गई कमांड के परिणाम में सिग्नल का नाम आता है; ख़त्म होने से पहले आउटपुट छपा होना कमांड की सफलता नहीं बताता।
- लंबे टास्क background में चलाएँ? Linux पर Gateway-मैनेज्ड background कमांड पर durable execution सक्षम किया जा सकता है, Gateway रीस्टार्ट के बाद भी जीवित रहती है।
- मेमोरी काफ़ी है? Linux पर Gateway-मैनेज्ड exec की डिफ़ॉल्ट मेमोरी सीमा होती है: होस्ट मेमोरी के चौथाई (या cgroup constraint) और Gateway के अपने residency के बाद बची मेमोरी के आधे में से छोटा मान, बिना किसी कॉन्फ़िगरेशन के।
सावधानी रिमाइंडर
execएक परिवर्तनीय shell सतह है:write,edit,apply_patchबंद करने सेexecread-only नहीं बन जाता। «टूल बंद करने» को fallback न बनाएँ, sandbox चाहिए तो sandbox कॉन्फ़िगर करें।- रिमोट
host=nodeनिष्पादन synchronoussystem.runसे चलता है,processसेशन नहीं बनाता;processप्रतिबंधित होने पर लोकल exec synchronous चलता है,yieldMsऔरbackgroundको नज़रअंदाज़ करता है, durable execution अस्वीकार हो जाता है। tools.fs.workspaceOnlyऔरtools.exec.applyPatch.workspaceOnlyअलग-अलग स्वतंत्र रूप सेapply_patchशामिल करते हैं, एक को हटाने पर दूसरा अभी भी लागू हो सकता है।
इस पाठ का सारांश
OpenClaw से कोड लिखते हुए आपने इस पाठ में पूरी श्रृंखला पूरी की: exec लोकल workspace में कमांड चलाकर फ़ेलियर डायग्नोसिस लाता है, apply_patch संरचित पैच से एक बार में कई फ़ाइलें बदलता है, अप्रूवल policy (tools.exec.mode + allowlist + यूज़र पुष्टि) हाई-रिस्क कमांड की रखवाली करती है, और Code Mode टूल बहुत होने पर मॉडल को एक सस्ता कॉल पाथ देता है। पैच राइट अप्रूवल पैनल से नहीं गुज़रता, बल्कि workspaceOnly, सेशन permission मोड और sandbox सीमा से नियंत्रित होता है — दोनों लाइनें अपना-अपना काम करती हैं, इन्हें न मिलाएँ।
अगले पाठ की झलक
कोड बदल गया, अगला कदम Claw को repo पर नज़र रखने दें: GitHub ड्यूटी: PR सारांश और issue की ऑटोमैटिक हैंडलिंग। टूल permissions कसने के लिए पढ़ेंसिक्योरिटी हार्डनिंग (दो): टूल permissions और sandbox; ज़्यादा किफ़ायती डेस्टिक मॉडल से कोडिंग के लिए देखेंDeepSeek जोड़ना: V4 सीरीज़ मॉडल कॉन्फ़िगरेशन व्यवहार।