ارسال عامل

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

شروع سریع

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 اجرا می‌شود. برای اجبار به استفاده از زمان‌اجرای تعبیه‌شده روی دستگاه فعلی، --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 مراجعه کنید.

نمونه‌ها

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

مرتبط