Agent coordination

ارسال عامل

openclaw agent یک نوبت منفرد عامل را از خط فرمان و بدون پیام گفت‌وگوی ورودی اجرا می‌کند. از آن برای گردش‌کارهای اسکریپتی، آزمایش و تحویل برنامه‌نویسی‌شده استفاده کنید. مرجع کامل پرچم‌ها و رفتار: مرجع CLI عامل.

شروع سریع

اجرای یک نوبت ساده عامل

bash

openclaw agent --agent main --message "آب‌وهوای امروز چگونه است؟"

پیام را از طریق Gateway ارسال می‌کند و پاسخ را نمایش می‌دهد.

ارسال یک درخواست چندخطی از فایل

bash

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

یک فایل UTF-8 معتبر را به‌عنوان بدنه پیام عامل می‌خواند.

هدف‌گیری یک عامل یا نشست مشخص

bash

# هدف‌گیری یک عامل مشخصopenclaw agent --agent ops --message "گزارش‌ها را خلاصه کن" # هدف‌گیری یک شماره تلفن (کلید نشست را استخراج می‌کند)openclaw agent --to +15555550123 --message "به‌روزرسانی وضعیت" # استفاده مجدد از یک نشست موجودopenclaw agent --session-id abc123 --message "کار را ادامه بده" # هدف‌گیری یک کلید نشست دقیقopenclaw agent --session-key agent:ops:incident-42 --message "وضعیت را خلاصه کن"

تحویل پاسخ به یک کانال

bash

# تحویل به WhatsApp (کانال پیش‌فرض)openclaw agent --to +15555550123 --message "گزارش آماده است" --deliver # تحویل به Slackopenclaw agent --agent ops --message "گزارش را تولید کن" \  --deliver --reply-channel slack --reply-to "#reports"

پرچم‌ها

پرچم	توضیحات
`--message <text>`	پیام درون‌خطی برای ارسال
`--message-file <path>`	خواندن پیام از یک فایل UTF-8 معتبر (حداکثر 4 MiB)
`--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، محتوای چندخطی را حفظ می‌کنند. فایل‌های بزرگ‌تر از 4 MiB پیش از ارسال رد می‌شوند.
پس از تلاش‌های مجدد موقت برای دست‌دهی، پایان مهلت Gateway یا بسته‌شدن اتصال باعث شکست فرمان همراه با یک راهنما در stderr می‌شود؛ CLI هرگز نوبت را بی‌سروصدا به‌صورت تعبیه‌شده دوباره اجرا نمی‌کند. ممکن است Gateway همچنان نوبت پذیرفته‌شده را تکمیل کند، بنابراین پیش از تلاش مجدد یا اجرای دوباره با --local، وضعیت 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

# نوبت ساده با خروجی JSONopenclaw agent --to +15555550123 --message "گزارش‌ها را ردیابی کن" --verbose on --json # نوبت با بازنویسی مدلopenclaw agent --agent ops --model openai/gpt-5.4 --message "گزارش‌ها را خلاصه کن" # نوبت با سطح تفکرopenclaw agent --session-id 1234 --message "صندوق ورودی را خلاصه کن" --thinking medium # درخواست چندخطی از فایلopenclaw agent --agent ops --message-file ./task.md # کلید نشست دقیقopenclaw agent --session-key agent:ops:incident-42 --message "وضعیت را خلاصه کن" # کلید قدیمی در دامنه یک عاملopenclaw agent --agent ops --session-key incident-42 --message "وضعیت را خلاصه کن" # تحویل به کانالی متفاوت از نشستopenclaw agent --agent ops --message "هشدار" --deliver --reply-channel telegram --reply-to "@admin"