Agent coordination

Pengiriman agen

openclaw agent menjalankan satu giliran agen dari baris perintah tanpa memerlukan pesan chat masuk. Gunakan untuk alur kerja berskrip, pengujian, dan pengiriman terprogram.

Mulai cepat

Jalankan giliran agen sederhana

bash

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

Ini mengirim pesan melalui Gateway dan mencetak balasannya.

Kirim prompt multibaris dari file

bash

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

Ini membaca file UTF-8 yang valid sebagai isi pesan agen.

Targetkan agen atau sesi tertentu

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"

Kirimkan balasan ke channel

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"

Flag

Flag	Deskripsi
`--message \<text\>`	Pesan inline untuk dikirim
`--message-file \<path\>`	Baca pesan dari file UTF-8 yang valid
`--to \<dest\>`	Turunkan kunci sesi dari target (telepon, id chat)
`--session-key \<key\>`	Gunakan kunci sesi eksplisit
`--agent \<id\>`	Targetkan agen yang dikonfigurasi (menggunakan sesi `main`)
`--session-id \<id\>`	Gunakan kembali sesi yang ada berdasarkan id
`--local`	Paksa runtime tertanam lokal (lewati Gateway)
`--deliver`	Kirim balasan ke channel chat
`--channel \<name\>`	Channel pengiriman (whatsapp, telegram, discord, slack, dll.)
`--reply-to \<target\>`	Override target pengiriman
`--reply-channel \<name\>`	Override channel pengiriman
`--reply-account \<id\>`	Override id akun pengiriman
`--thinking \<level\>`	Atur tingkat berpikir untuk profil model yang dipilih
`--verbose \<on\|full\|off\>`	Atur tingkat verbose
`--timeout \<seconds\>`	Override timeout agen
`--json`	Keluarkan JSON terstruktur

Perilaku

Secara default, CLI berjalan melalui Gateway. Tambahkan --local untuk memaksa runtime tertanam di mesin saat ini.
Berikan tepat salah satu dari --message atau --message-file. Pesan file mempertahankan konten multibaris setelah menghapus BOM UTF-8 opsional.
Jika Gateway tidak dapat dijangkau, CLI fallback ke eksekusi tertanam lokal.
Pemilihan sesi: --to menurunkan kunci sesi (target grup/channel mempertahankan isolasi; chat langsung diciutkan ke main).
--session-key memilih kunci eksplisit. Kunci berprefiks agen harus menggunakan agent:<agent-id>:<session-key>, dan --agent harus cocok dengan id agen tersebut saat keduanya diberikan. Kunci non-sentinel polos dicakup ke --agent saat diberikan; misalnya, --agent ops --session-key incident-42 dirutekan ke agent:ops:incident-42. Tanpa --agent, kunci non-sentinel polos dicakup ke agen default yang dikonfigurasi. Literal global dan unknown tetap tidak tercakup hanya ketika tidak ada --agent yang diberikan; dalam kasus tersebut, fallback tertanam dan kepemilikan store menggunakan agen default yang dikonfigurasi.
Flag thinking dan verbose dipertahankan ke dalam store sesi.
Output: teks polos secara default, atau --json untuk payload + metadata terstruktur.
Dengan --json --deliver, JSON menyertakan status pengiriman untuk pengiriman yang terkirim, ditekan, parsial, dan gagal. Lihat Status pengiriman JSON.

Contoh

bash

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