Skip to main content
openclaw agent बिना किसी इनबाउंड चैट संदेश के कमांड लाइन से एजेंट का एकल टर्न चलाता है। इसका उपयोग स्क्रिप्टेड कार्यप्रवाहों, परीक्षण और प्रोग्रामेटिक डिलीवरी के लिए करें। फ़्लैग और व्यवहार का पूरा संदर्भ: एजेंट CLI संदर्भ

त्वरित शुरुआत

1

एजेंट का एक सरल टर्न चलाएँ

संदेश को Gateway के माध्यम से भेजता है और उत्तर प्रिंट करता है।
2

फ़ाइल से बहु-पंक्ति प्रॉम्प्ट भेजें

एजेंट संदेश के मुख्य भाग के रूप में एक मान्य UTF-8 फ़ाइल पढ़ता है।
3

किसी विशिष्ट एजेंट या सत्र को लक्षित करें

4

उत्तर किसी चैनल पर डिलीवर करें

फ़्लैग

व्यवहार

  • डिफ़ॉल्ट रूप से, CLI Gateway के माध्यम से जाता है। वर्तमान मशीन पर एम्बेडेड रनटाइम बाध्य करने के लिए --local जोड़ें।
  • --message या --message-file में से ठीक एक पास करें। फ़ाइल संदेश वैकल्पिक UTF-8 BOM हटाने के बाद बहु-पंक्ति सामग्री संरक्षित रखते हैं। 4 MiB से बड़ी फ़ाइलें डिस्पैच से पहले अस्वीकार कर दी जाती हैं।
  • क्षणिक हैंडशेक पुनः प्रयासों के बाद, Gateway टाइमआउट या बंद कनेक्शन stderr संकेत के साथ कमांड को विफल कर देता है; CLI कभी भी टर्न को एम्बेडेड रूप में चुपचाप दोबारा नहीं चलाता। Gateway किसी स्वीकृत टर्न को फिर भी पूरा कर सकता है, इसलिए पुनः प्रयास करने या --local के साथ दोबारा चलाने से पहले Gateway और सत्र की स्थिति सत्यापित करें।
  • सत्र चयन: --to सत्र कुंजी प्राप्त करता है (समूह/चैनल लक्ष्य अलगाव बनाए रखते हैं; प्रत्यक्ष चैट main में समाहित हो जाती हैं)। --agent, --channel और --to को एक साथ देने पर रूटिंग चैनल के कैनोनिकल प्राप्तकर्ता और session.dmScope का अनुसरण करती है। स्थिर केवल-आउटबाउंड पहचानें, एजेंट के मुख्य सत्र से अलग किए गए प्रदाता-स्वामित्व वाले सत्र का उपयोग करती हैं।
  • --session-key एक स्पष्ट कुंजी चुनता है। एजेंट-प्रीफ़िक्स वाली कुंजियों को agent:<agent-id>:<session-key> का उपयोग करना आवश्यक है, और दोनों दिए जाने पर --agent का उस एजेंट आईडी से मेल खाना आवश्यक है। यदि --agent दिया गया हो, तो बिना उपसर्ग वाली गैर-सेंटिनल कुंजियाँ उसके दायरे में होती हैं; उदाहरण के लिए, --agent ops --session-key incident-42 को agent:ops:incident-42 पर रूट किया जाता है। --agent के बिना, बिना उपसर्ग वाली गैर-सेंटिनल कुंजियाँ कॉन्फ़िगर किए गए डिफ़ॉल्ट एजेंट के दायरे में होती हैं। शाब्दिक global और unknown केवल तभी दायरे से बाहर रहते हैं जब कोई --agent न दिया गया हो।
  • --reply-channel और --reply-account केवल डिलीवरी को प्रभावित करते हैं।
  • चिंतन और वर्बोज़ फ़्लैग सत्र स्टोर में बने रहते हैं।
  • आउटपुट: डिफ़ॉल्ट रूप से सादा टेक्स्ट, या संरचित पेलोड + मेटाडेटा के लिए --json
  • --json --deliver के साथ, JSON में भेजी गई, दबाई गई, आंशिक और विफल डिलीवरी की स्थिति शामिल होती है। JSON डिलीवरी स्थिति देखें।

उदाहरण

संबंधित

एजेंट CLI संदर्भ

पूर्ण openclaw agent फ़्लैग और विकल्प संदर्भ।

उप-एजेंट

पृष्ठभूमि में उप-एजेंट बनाना।

सत्र

सत्र कुंजियाँ कैसे काम करती हैं और --to, --agent तथा --session-id उन्हें कैसे हल करते हैं।

स्लैश कमांड

एजेंट सत्रों के भीतर उपयोग की जाने वाली नेटिव कमांड सूची।