إرسال الوكيل

​

البدء السريع

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 يرجع احتياطيًا إلى التشغيل المضمّن المحلي.
• اختيار الجلسة: يشتق --to مفتاح الجلسة (تحافظ أهداف المجموعة/القناة على العزل؛ وتُطوى الدردشات المباشرة إلى main).
• يحدد --session-key مفتاحًا صريحًا. يجب أن تستخدم المفاتيح ذات بادئة الوكيل agent:<agent-id>:<session-key>، ويجب أن يطابق --agent معرّف ذلك الوكيل عند توفيرهما معًا. تُنسب المفاتيح العارية غير الحارسة إلى --agent عند توفيره؛ على سبيل المثال، يوجّه --agent ops --session-key incident-42 إلى agent:ops:incident-42. من دون --agent، تُنسب المفاتيح العارية غير الحارسة إلى الوكيل الافتراضي المضبوط. تبقى القيمتان الحرفيتان global وunknown غير منسوبتين فقط عند عدم توفير --agent؛ في هذه الحالة، يستخدم الرجوع المضمّن وملكية المخزن الوكيل الافتراضي المضبوط.
• تستمر علامتا التفكير والإسهاب في مخزن الجلسة.
• الإخراج: نص عادي افتراضيًا، أو --json لحمولة منظّمة + بيانات وصفية.
• مع --json --deliver، يتضمن JSON حالة التسليم للإرسالات المرسلة، والمكبوتة، والجزئية، والفاشلة. راجع حالة تسليم JSON.

​

أمثلة

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

# 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"

​

ذات صلة