ارسال عامل

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

شروع سریع

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

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

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

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

پرچم‌ها

رفتار

• به‌صورت پیش‌فرض، CLI از طریق Gateway اجرا می‌شود. برای اجبار به استفاده از runtime تعبیه‌شده روی ماشین فعلی، --local را اضافه کنید.
• دقیقاً یکی از --message یا --message-file را بدهید. پیام‌های فایل پس از حذف BOM اختیاری UTF-8، محتوای چندخطی را حفظ می‌کنند.
• اگر Gateway در دسترس نباشد، CLI به اجرای تعبیه‌شده محلی fallback می‌کند.
• انتخاب نشست: --to کلید نشست را استخراج می‌کند (هدف‌های گروه/کانال جداسازی را حفظ می‌کنند؛ چت‌های مستقیم به main فروکاسته می‌شوند).
• --session-key یک کلید صریح را انتخاب می‌کند. کلیدهای دارای پیشوند عامل باید از agent:<agent-id>:<session-key> استفاده کنند، و وقتی هر دو ارائه شوند، --agent باید با همان شناسه عامل مطابقت داشته باشد. کلیدهای خام غیر sentinel وقتی --agent ارائه شود در محدوده آن قرار می‌گیرند؛ برای مثال، --agent ops --session-key incident-42 به agent:ops:incident-42 مسیریابی می‌شود. بدون --agent، کلیدهای خام غیر sentinel در محدوده عامل پیش‌فرض پیکربندی‌شده قرار می‌گیرند. مقدارهای لفظی global و unknown فقط وقتی --agent ارائه نشده باشد بدون محدوده باقی می‌مانند؛ در آن حالت، fallback تعبیه‌شده و مالکیت store از عامل پیش‌فرض پیکربندی‌شده استفاده می‌کنند.
• پرچم‌های تفکر و پرگویی در store نشست پایدار می‌مانند.
• خروجی: به‌صورت پیش‌فرض متن ساده، یا --json برای payload ساخت‌یافته + metadata.
• با --json --deliver، JSON وضعیت تحویل را برای ارسال‌های انجام‌شده، سرکوب‌شده، جزئی، و ناموفق شامل می‌شود. وضعیت تحویل JSON را ببینید.

نمونه‌ها

# Simple turn with JSON outputopenclaw agent --to +15555550123 --message "Trace logs" --verbose on --json # 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"

مرتبط