إرسال الوكيل

​

البدء السريع

openclaw agent --agent main --message "What is the weather today?"

openclaw agent --agent ops --message-file ./task.md

# Target a specific agent
openclaw agent --agent ops --message "Summarize logs"

# Target a phone number (derives session key)
openclaw agent --to +15555550123 --message "Status update"

# Reuse an existing session
openclaw agent --session-id abc123 --message "Continue the task"

# Target an exact session key
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

# Deliver to WhatsApp (default channel)
openclaw agent --to +15555550123 --message "Report ready" --deliver

# Deliver to Slack
openclaw agent --agent ops --message "Generate report" \
  --deliver --reply-channel slack --reply-to "#reports"

​

العلامات

​

السلوك

• يمر CLI افتراضيًا عبر Gateway. أضف --local لفرض بيئة التشغيل المضمّنة على الجهاز الحالي.
• مرّر واحدًا فقط من --message أو --message-file. تحافظ رسائل الملفات على المحتوى متعدد الأسطر بعد إزالة علامة BOM اختيارية بترميز UTF-8.
• إذا فشل طلب Gateway، يتراجع CLI إلى التشغيل المحلي المضمّن؛ وعند انتهاء مهلة 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.

​

أمثلة

# Simple turn with JSON output
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json

# Turn with a model override
openclaw agent --agent ops --model openai/gpt-5.4 --message "Summarize logs"

# Turn with thinking level
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium

# Multiline prompt from a file
openclaw agent --agent ops --message-file ./task.md

# Exact session key
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

# Legacy key scoped to an agent
openclaw agent --agent ops --session-key incident-42 --message "Summarize status"

# Deliver to a different channel than the session
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

​

ذو صلة