​

openclaw agent

​

विकल्प

• -m, --message <text>: संदेश का मुख्य भाग
• --message-file <path>: UTF-8 फ़ाइल से संदेश का मुख्य भाग पढ़ें
• -t, --to <dest>: सेशन कुंजी प्राप्त करने के लिए प्रयुक्त प्राप्तकर्ता
• --session-key <key>: रूटिंग के लिए उपयोग की जाने वाली स्पष्ट सेशन कुंजी
• --session-id <id>: स्पष्ट सेशन आईडी
• --agent <id>: एजेंट आईडी; रूटिंग बाइंडिंग को ओवरराइड करती है
• --model <id>: इस रन के लिए मॉडल ओवरराइड (provider/model या मॉडल आईडी)
• --thinking <level>: एजेंट का चिंतन स्तर (off, minimal, low, medium, high, और प्रदाता-समर्थित कस्टम स्तर, जैसे xhigh, adaptive, या max)
• --verbose <on|off>: सेशन के लिए विस्तृतता स्तर बनाए रखें
• --channel <channel>: डिलीवरी चैनल; मुख्य सेशन चैनल का उपयोग करने के लिए इसे छोड़ दें
• --reply-to <target>: डिलीवरी लक्ष्य ओवरराइड
• --reply-channel <channel>: डिलीवरी चैनल ओवरराइड
• --reply-account <id>: डिलीवरी अकाउंट ओवरराइड
• --local: एम्बेडेड एजेंट को सीधे चलाएँ (Plugin रजिस्ट्री प्रीलोड के बाद)
• --deliver: चयनित चैनल/लक्ष्य पर उत्तर वापस भेजें
• --timeout <seconds>: इस कमांड की एजेंट-टर्न समय-सीमा को ओवरराइड करें (डिफ़ॉल्ट 600, या agents.defaults.timeoutSeconds); 0 समग्र समय-सीमा अक्षम करता है। 600-सेकंड का फ़ॉलबैक इस CLI कमांड से संबंधित है, सामान्य Gateway टर्न से नहीं, जिनका डिफ़ॉल्ट 48 घंटे है।
• --json: JSON आउटपुट करें

​

उदाहरण

openclaw agent --to +15555550123 --message "स्थिति अपडेट" --deliver
openclaw agent --agent ops --message "लॉग का सारांश दें"
openclaw agent --agent ops --message-file ./task.md
openclaw agent --agent ops --model openai/gpt-5.4 --message "लॉग का सारांश दें"
openclaw agent --session-key agent:ops:incident-42 --message "स्थिति का सारांश दें"
openclaw agent --agent ops --session-key incident-42 --message "स्थिति का सारांश दें"
openclaw agent --session-id 1234 --message "इनबॉक्स का सारांश दें" --thinking medium
openclaw agent --to +15555550123 --message "लॉग ट्रेस करें" --verbose on --json
openclaw agent --agent ops --message "रिपोर्ट बनाएँ" --deliver --reply-channel slack --reply-to "#reports"
openclaw agent --agent ops --message "स्थानीय रूप से चलाएँ" --local

​

टिप्पणियाँ

• --message या --message-file में से ठीक एक दें। --message-file आरंभिक UTF-8 BOM हटाता है और बहु-पंक्ति सामग्री सुरक्षित रखता है; यह ऐसी फ़ाइलें अस्वीकार करता है जो मान्य UTF-8 नहीं हैं। 4 MiB से बड़ी फ़ाइलें प्रेषण से पहले अस्वीकार कर दी जाती हैं।
• स्लैश कमांड (उदाहरण के लिए /compact) --message के माध्यम से नहीं चल सकते। CLI उन्हें अस्वीकार करता है और इसके बजाय आपको प्रथम-श्रेणी कमांड की ओर निर्देशित करता है (Compaction के लिए openclaw sessions compact <key>)।
• --local रन एकल-प्रयोग वाले हैं: रन के लिए खोले गए बंडल MCP लूपबैक संसाधन और सक्रिय Claude stdio सेशन उत्तर के बाद समाप्त कर दिए जाते हैं, ताकि स्क्रिप्ट किए गए आह्वान स्थानीय चाइल्ड प्रोसेस को चलता हुआ न छोड़ें। इसके बजाय Gateway-समर्थित रन, चल रही Gateway प्रक्रिया के अंतर्गत Gateway-स्वामित्व वाले MCP लूपबैक संसाधन बनाए रखते हैं।
• --local के साथ स्वतंत्र एम्बेडेड निष्पादन, पुनरारंभ पुनर्प्राप्ति लंबित होने पर मौजूदा मुख्य सेशन का पुनः उपयोग करने से मना करता है। टर्न को किसी स्वस्थ Gateway के माध्यम से चलाएँ, या वहाँ /new अथवा /reset से इसे रीसेट करें; कोई स्वतंत्र एम्बेडेड प्रक्रिया उस पुनर्प्राप्ति स्वामी का Gateway स्कैनर के साथ सुरक्षित समन्वय नहीं कर सकती।
• --agent, --channel और --to को एक साथ उपयोग करने पर, सेशन रूटिंग चैनल के कैनोनिकल प्राप्तकर्ता और session.dmScope का अनुसरण करती है। स्थिर केवल-आउटबाउंड प्राप्तकर्ता पहचान वाले चैनल, एजेंट के मुख्य सेशन से पृथक प्रदाता-स्वामित्व वाले सेशन का उपयोग करते हैं। --reply-channel और --reply-account केवल डिलीवरी को प्रभावित करते हैं।
• --session-key एक स्पष्ट सेशन कुंजी चुनता है। एजेंट-उपसर्ग वाली कुंजियों को agent:<agent-id>:<session-key> का उपयोग करना आवश्यक है, और दोनों दिए जाने पर --agent को कुंजी की एजेंट आईडी से मेल खाना आवश्यक है। बिना उपसर्ग वाली गैर-सेंटिनल कुंजियाँ, दिए जाने पर --agent के दायरे में या अन्यथा कॉन्फ़िगर किए गए डिफ़ॉल्ट एजेंट के दायरे में होती हैं; उदाहरण के लिए --agent ops --session-key incident-42, agent:ops:incident-42 पर रूट करता है। शाब्दिक कुंजियाँ global और unknown केवल तभी दायरे से बाहर रहती हैं जब कोई --agent न दिया गया हो।
• --json JSON प्रतिक्रिया के लिए stdout आरक्षित करता है; Gateway, Plugin और --local निदान stderr पर जाते हैं, ताकि स्क्रिप्ट stdout को सीधे पार्स कर सकें।
• क्षणिक हैंडशेक पुनःप्रयास समाप्त होने के बाद, Gateway टाइमआउट या बंद कनेक्शन से कमांड विफल हो जाता है; CLI कभी भी टर्न को चुपचाप एम्बेडेड रूप में दोबारा नहीं चलाता। ट्रांसपोर्ट हानि अस्पष्ट होती है—हो सकता है Gateway ने टर्न स्वीकार कर लिया हो और अभी भी उसे पूरा कर रहा हो—इसलिए stderr संकेत पुनःप्रयास करने या --local के साथ दोबारा चलाने से पहले openclaw gateway status और सेशन ट्रांसक्रिप्ट जाँचने को कहता है, ताकि टर्न दो बार निष्पादित न हो।
• SIGTERM/SIGINT प्रतीक्षारत Gateway-समर्थित अनुरोध को बाधित करते हैं; यदि Gateway ने रन पहले ही स्वीकार कर लिया है, तो CLI बाहर निकलने से पहले उस रन आईडी के लिए chat.abort भी भेजता है। --local रन को वही संकेत मिलता है, लेकिन वे chat.abort नहीं भेजते। पहले अग्रेषित SIGINT या SIGTERM से समाप्त होने वाला लॉन्चर चाइल्ड क्रमशः स्थिति 130 या 143 के साथ बाहर निकलता है। यदि आंतरिक रन-डीडुप कुंजी में इस सेशन के लिए पहले से कोई सक्रिय रन है, तो प्रतिक्रिया status: "in_flight" रिपोर्ट करती है और गैर-JSON CLI रिक्त उत्तर के बजाय stderr निदान प्रिंट करता है। बाहरी cron/systemd रैपर के लिए, timeout -k 60 600 openclaw agent ... जैसा हार्ड-किल बैकस्टॉप रखें, ताकि शटडाउन पूरा न हो पाने पर पर्यवेक्षक प्रक्रिया को समाप्त कर सके।
• जब यह कमांड models.json पुनर्जनन आरंभ करता है, तो SecretRef-प्रबंधित प्रदाता क्रेडेंशियल गैर-गोपनीय मार्कर के रूप में सहेजे जाते हैं (उदाहरण के लिए एनवायरनमेंट वैरिएबल नाम, secretref-env:ENV_VAR_NAME, या secretref-managed), कभी भी हल किए गए गोपनीय प्लेनटेक्स्ट के रूप में नहीं। मार्कर लेखन सक्रिय स्रोत कॉन्फ़िगरेशन स्नैपशॉट से आता है, हल किए गए रनटाइम गोपनीय मानों से नहीं।

​

JSON डिलीवरी स्थिति

{
  "payloads": [{ "text": "रिपोर्ट तैयार है", "mediaUrl": null }],
  "meta": { "durationMs": 1200 },
  "deliveryStatus": {
    "requested": true,
    "attempted": true,
    "status": "sent",
    "succeeded": true,
    "resultCount": 1
  }
}

• requested: ऑब्जेक्ट मौजूद होने पर हमेशा true।
• attempted: स्थायी प्रेषण पथ चलने के बाद true; प्रीफ़्लाइट विफलताओं या कोई दृश्य पेलोड न होने पर false।
• succeeded: true, false, या "partial"; "partial", status: "partial_failed" के साथ युग्मित होता है।
• reason: स्थायी डिलीवरी या प्रीफ़्लाइट सत्यापन से प्राप्त लोअरकेस स्नेक-केस कारण। ज्ञात मानों में cancelled_by_message_sending_hook, no_visible_payload, no_visible_result, channel_resolved_to_internal, unknown_channel, invalid_delivery_target, और no_delivery_target शामिल हैं; विफल स्थायी प्रेषण विफल चरण भी रिपोर्ट कर सकते हैं। अज्ञात मानों को अपारदर्शी मानें, क्योंकि यह समुच्चय विस्तृत हो सकता है।
• resultCount: उपलब्ध होने पर चैनल प्रेषण परिणामों की संख्या।
• sentBeforeError: जब आंशिक विफलता में त्रुटि से पहले कम-से-कम एक पेलोड भेजा गया हो, तब true।
• error: विफल या आंशिक-विफल प्रेषणों के लिए true।
• errorMessage: केवल तभी मौजूद होता है जब अंतर्निहित डिलीवरी त्रुटि संदेश कैप्चर किया गया हो। प्रीफ़्लाइट विफलताओं में error/reason होते हैं, लेकिन errorMessage नहीं।
• payloadOutcomes: उपलब्ध होने पर index, status, reason, resultCount, error, stage, sentBeforeError, या हुक मेटाडेटा वाले वैकल्पिक प्रति-पेलोड परिणाम।

​

संबंधित

• CLI संदर्भ
• एजेंट रनटाइम