---
read_when:
    - आप स्क्रिप्ट या कमांड लाइन से एजेंट रन ट्रिगर करना चाहते हैं
    - आपको एजेंट के उत्तर प्रोग्राम के माध्यम से किसी चैट चैनल पर भेजने हैं
summary: CLI से एजेंट टर्न चलाएँ और वैकल्पिक रूप से चैनलों पर उत्तर भेजें
title: एजेंट भेजना
x-i18n:
    generated_at: "2026-07-27T18:36:00Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: ad3da0feea102725ebb5555e0dd375ed6f3a0396d8ffd0ab916ced303201eabc
    source_path: tools/agent-send.md
    workflow: 16
---

`openclaw agent` बिना किसी इनबाउंड चैट संदेश के कमांड लाइन से एजेंट का एकल टर्न चलाता है। इसका उपयोग स्क्रिप्टेड कार्यप्रवाहों, परीक्षण और प्रोग्रामेटिक डिलीवरी के लिए करें। फ़्लैग और व्यवहार का पूरा संदर्भ:
[एजेंट CLI संदर्भ](/hi/cli/agent)।

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

<Steps>
  <Step title="एजेंट का एक सरल टर्न चलाएँ">
    ```bash
    openclaw agent --agent main --message "आज मौसम कैसा है?"
    ```

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

  </Step>

  <Step title="फ़ाइल से बहु-पंक्ति प्रॉम्प्ट भेजें">
    ```bash
    openclaw agent --agent ops --message-file ./task.md
    ```

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

  </Step>

  <Step title="किसी विशिष्ट एजेंट या सत्र को लक्षित करें">
    ```bash
    # किसी विशिष्ट एजेंट को लक्षित करें
    openclaw agent --agent ops --message "लॉग का सारांश दें"

    # किसी फ़ोन नंबर को लक्षित करें (सत्र कुंजी प्राप्त करता है)
    openclaw agent --to +15555550123 --message "स्थिति अपडेट"

    # किसी मौजूदा सत्र का पुनः उपयोग करें
    openclaw agent --session-id abc123 --message "कार्य जारी रखें"

    # किसी सटीक सत्र कुंजी को लक्षित करें
    openclaw agent --session-key agent:ops:incident-42 --message "स्थिति का सारांश दें"
    ```

  </Step>

  <Step title="उत्तर किसी चैनल पर डिलीवर करें">
    ```bash
    # WhatsApp पर डिलीवर करें (डिफ़ॉल्ट चैनल)
    openclaw agent --to +15555550123 --message "रिपोर्ट तैयार है" --deliver

    # Slack पर डिलीवर करें
    openclaw agent --agent ops --message "रिपोर्ट जनरेट करें" \
      --deliver --reply-channel slack --reply-to "#reports"
    ```

  </Step>
</Steps>

## फ़्लैग

| फ़्लैग                       | विवरण                                                                 |
| --------------------------- | -------------------------------------------------------------------- |
| `--message <text>`          | भेजने के लिए इनलाइन संदेश                                             |
| `--message-file <path>`     | किसी मान्य UTF-8 फ़ाइल से संदेश पढ़ें (अधिकतम 4 MiB)                 |
| `--to <dest>`               | किसी लक्ष्य (फ़ोन, चैट आईडी) से सत्र कुंजी प्राप्त करें              |
| `--session-key <key>`       | किसी स्पष्ट सत्र कुंजी का उपयोग करें                                  |
| `--agent <id>`              | किसी कॉन्फ़िगर किए गए एजेंट को लक्षित करें (उसके `main` सत्र का उपयोग करता है) |
| `--session-id <id>`         | आईडी द्वारा किसी मौजूदा सत्र का पुनः उपयोग करें                       |
| `--model <id>`              | इस रन के लिए मॉडल ओवरराइड (`provider/model` या मॉडल आईडी)          |
| `--local`                   | स्थानीय एम्बेडेड रनटाइम बाध्य करें (Gateway को छोड़ें)               |
| `--deliver`                 | उत्तर किसी चैट चैनल पर भेजें                                         |
| `--channel <name>`          | डिलीवरी चैनल; `--agent` + `--to` के साथ, DM का दायरा भी लागू करता है |
| `--reply-to <target>`       | डिलीवरी लक्ष्य ओवरराइड                                                |
| `--reply-channel <name>`    | डिलीवरी चैनल ओवरराइड                                                  |
| `--reply-account <id>`      | डिलीवरी खाता आईडी ओवरराइड                                             |
| `--thinking <level>`        | चयनित मॉडल प्रोफ़ाइल के लिए चिंतन स्तर सेट करें                       |
| `--verbose <on\|full\|off>` | सत्र के लिए वर्बोज़ स्तर बनाए रखें (`full` टूल आउटपुट भी लॉग करता है) |
| `--timeout <seconds>`       | एजेंट टाइमआउट ओवरराइड करें (डिफ़ॉल्ट 600 या कॉन्फ़िगरेशन मान)        |
| `--json`                    | संरचित JSON आउटपुट करें                                               |

## व्यवहार

- डिफ़ॉल्ट रूप से, 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 डिलीवरी स्थिति](/hi/cli/agent#json-delivery-status) देखें।

## उदाहरण

```bash
# JSON आउटपुट वाला सरल टर्न
openclaw agent --to +15555550123 --message "लॉग ट्रेस करें" --verbose on --json

# मॉडल ओवरराइड वाला टर्न
openclaw agent --agent ops --model openai/gpt-5.4 --message "लॉग का सारांश दें"

# चिंतन स्तर वाला टर्न
openclaw agent --session-id 1234 --message "इनबॉक्स का सारांश दें" --thinking medium

# फ़ाइल से बहु-पंक्ति प्रॉम्प्ट
openclaw agent --agent ops --message-file ./task.md

# सटीक सत्र कुंजी
openclaw agent --session-key agent:ops:incident-42 --message "स्थिति का सारांश दें"

# एजेंट के दायरे में लीगेसी कुंजी
openclaw agent --agent ops --session-key incident-42 --message "स्थिति का सारांश दें"

# सत्र से अलग चैनल पर डिलीवर करें
openclaw agent --agent ops --message "चेतावनी" --deliver --reply-channel telegram --reply-to "@admin"
```

## संबंधित

<CardGroup cols={2}>
  <Card title="एजेंट CLI संदर्भ" href="/hi/cli/agent" icon="terminal">
    पूर्ण `openclaw agent` फ़्लैग और विकल्प संदर्भ।
  </Card>
  <Card title="उप-एजेंट" href="/hi/tools/subagents" icon="users">
    पृष्ठभूमि में उप-एजेंट बनाना।
  </Card>
  <Card title="सत्र" href="/hi/concepts/session" icon="comments">
    सत्र कुंजियाँ कैसे काम करती हैं और `--to`, `--agent` तथा `--session-id` उन्हें कैसे हल करते हैं।
  </Card>
  <Card title="स्लैश कमांड" href="/hi/tools/slash-commands" icon="slash">
    एजेंट सत्रों के भीतर उपयोग की जाने वाली नेटिव कमांड सूची।
  </Card>
</CardGroup>