إرسال الوكيل

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

البدء السريع

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 يرجع احتياطيًا إلى التشغيل المضمّن المحلي.
• اختيار الجلسة: يشتق --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 outputopenclaw agent --to +15555550123 --message "Trace logs" --verbose on --json # 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"

ذات صلة