Agent coordination
إرسال الوكيل
يشغّل openclaw agent دورة وكيل واحدة من سطر الأوامر دون الحاجة إلى
رسالة دردشة واردة. استخدمه لسير العمل النصية، والاختبار، والتسليم
البرمجي.
البدء السريع
تشغيل دورة وكيل بسيطة
openclaw agent --message "What is the weather today?"يرسل هذا الرسالة عبر Gateway ويطبع الرد.
استهداف وكيل أو جلسة محددة
# 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"تسليم الرد إلى قناة
# 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"العلامات
| العلامة | الوصف |
|---|---|
--message \<text\> |
الرسالة المراد إرسالها (مطلوبة) |
--to \<dest\> |
اشتقاق مفتاح الجلسة من هدف (هاتف، معرّف دردشة) |
--agent \<id\> |
استهداف وكيل مُعدّ (يستخدم جلسة main الخاصة به) |
--session-id \<id\> |
إعادة استخدام جلسة موجودة حسب المعرّف |
--local |
فرض وقت التشغيل المضمّن المحلي (تجاوز Gateway) |
--deliver |
إرسال الرد إلى قناة دردشة |
--channel \<name\> |
قناة التسليم (whatsapp، telegram، discord، slack، إلخ) |
--reply-to \<target\> |
تجاوز هدف التسليم |
--reply-channel \<name\> |
تجاوز قناة التسليم |
--reply-account \<id\> |
تجاوز معرّف حساب التسليم |
--thinking \<level\> |
ضبط مستوى التفكير لملف تعريف النموذج المحدد |
--verbose \<on|full|off\> |
ضبط مستوى الإسهاب |
--timeout \<seconds\> |
تجاوز مهلة الوكيل |
--json |
إخراج JSON منظّم |
السلوك
- افتراضيًا، تمر CLI عبر Gateway. أضف
--localلفرض وقت التشغيل المضمّن على الجهاز الحالي. - إذا تعذّر الوصول إلى Gateway، تعود CLI إلى التشغيل المضمّن المحلي.
- اختيار الجلسة: يشتق
--toمفتاح الجلسة (تحافظ أهداف المجموعة/القناة على العزل؛ وتُدمج الدردشات المباشرة فيmain). - تستمر علامات التفكير والإسهاب في مخزن الجلسات.
- الإخراج: نص عادي افتراضيًا، أو
--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 # Deliver to a different channel than the sessionopenclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"