Agent coordination

إرسال الوكيل

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

البدء السريع

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

bash

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

يرسل الرسالة عبر Gateway ويطبع الرد.

إرسال مطالبة متعددة الأسطر من ملف

bash

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

يقرأ ملف UTF-8 صالحًا باعتباره نص رسالة الوكيل.

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

bash

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

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

bash

# 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>`	رسالة مضمّنة لإرسالها
`--message-file <path>`	قراءة الرسالة من ملف UTF-8 صالح
`--to <dest>`	اشتقاق مفتاح الجلسة من وجهة مستهدفة (هاتف، معرّف محادثة)
`--session-key <key>`	استخدام مفتاح جلسة صريح
`--agent <id>`	استهداف وكيل مُعَدّ (يستخدم جلسته `main`)
`--session-id <id>`	إعادة استخدام جلسة موجودة حسب المعرّف
`--model <id>`	تجاوز النموذج لهذا التشغيل (`provider/model` أو معرّف النموذج)
`--local`	فرض بيئة التشغيل المحلية المضمّنة (تجاوز Gateway)
`--deliver`	إرسال الرد إلى قناة محادثة
`--channel <name>`	قناة التسليم؛ ومع `--agent` + `--to`، ينطبق أيضًا على نطاق الرسائل الخاصة
`--reply-to <target>`	تجاوز وجهة التسليم
`--reply-channel <name>`	تجاوز قناة التسليم
`--reply-account <id>`	تجاوز معرّف حساب التسليم
`--thinking <level>`	تعيين مستوى التفكير لملف تعريف النموذج المحدد
`--verbose <on\|full\|off>`	حفظ مستوى الإسهاب للجلسة (`full` يسجّل أيضًا مخرجات الأدوات)
`--timeout <seconds>`	تجاوز مهلة الوكيل (الافتراضي 600، أو قيمة الإعداد)
`--json`	إخراج JSON منظّم

السلوك

يمر 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.

أمثلة

bash

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