الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
البدء السريع

1

تشغيل دورة وكيل بسيطة

openclaw agent --message "What is the weather today?"
يرسل هذا الرسالة عبر Gateway ويطبع الرد.
2

استهداف وكيل أو جلسة محددة

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

تسليم الرد إلى قناة

# 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 لحمولة منظّمة + بيانات وصفية.
  • مع --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

# Deliver to a different channel than the session
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

​
ذات صلة

مرجع CLI للوكيل

مرجع كامل لعلامات وخيارات openclaw agent.

الوكلاء الفرعيون

إنشاء وكلاء فرعيين في الخلفية.

الجلسات

كيف تعمل مفاتيح الجلسات وكيف يحلّ --to و--agent و--session-id إليها.

أوامر الشرطة المائلة

كتالوج الأوامر الأصلي المستخدم داخل جلسات الوكيل.