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"