إرسال الوكيل

يشغّل الأمر openclaw agent دورة واحدة للوكيل من سطر الأوامر من دون رسالة محادثة واردة. استخدمه لسير العمل المعتمد على البرامج النصية والاختبار والتسليم البرمجي. المرجع الكامل للعلامات والسلوك: مرجع CLI للوكيل.

البدء السريع

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

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

# Target a specific agentopenclaw agent --agent ops --message "Summarize logs" # Target a phone number (derives session key)openclaw agent --to +15555550123 --message "Status update" # Reuse an existing sessionopenclaw agent --session-id abc123 --message "Continue the task" # Target an exact session keyopenclaw 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 Slackopenclaw 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 outputopenclaw agent --to +15555550123 --message "Trace logs" --verbose on --json # Turn with a model overrideopenclaw agent --agent ops --model openai/gpt-5.4 --message "Summarize logs" # Turn with thinking levelopenclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium # Multiline prompt from a fileopenclaw agent --agent ops --message-file ./task.md # Exact session keyopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status" # Legacy key scoped to an agentopenclaw agent --agent ops --session-key incident-42 --message "Summarize status" # Deliver to a different channel than the sessionopenclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

ذو صلة