Agent coordination
إرسال الوكيل
openclaw agent يشغّل دورة وكيل واحدة من سطر الأوامر دون الحاجة إلى
رسالة دردشة واردة. استخدمه لسير العمل المعتمدة على السكريبتات، والاختبار، و
التسليم البرمجي.
البدء السريع
تشغيل دورة وكيل بسيطة
openclaw agent --message "What is the weather today?"
يرسل هذا الرسالة عبر Gateway ويطبع الرد.
استهداف وكيل أو جلسة محددة
# 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"
تسليم الرد إلى قناة
# 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"
الخيارات
| الخيار | الوصف |
|---|---|
--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لحمولة منظمة + بيانات وصفية.
أمثلة
# 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
# Deliver to a different channel than the session
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"