Agent coordination

Pengiriman agen

openclaw agent menjalankan satu giliran agen dari baris perintah tanpa pesan obrolan masuk. Gunakan untuk alur kerja berskrip, pengujian, dan pengiriman terprogram. Referensi lengkap tanda dan perilaku: Referensi CLI agen.

Mulai cepat

Jalankan giliran agen sederhana

bash

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

Mengirim pesan melalui Gateway dan mencetak balasannya.

Kirim perintah multibaris dari berkas

bash

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

Membaca berkas UTF-8 yang valid sebagai isi pesan agen.

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

Kirim balasan ke saluran

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"

Tanda

Tanda	Deskripsi
`--message <text>`	Pesan sebaris yang akan dikirim
`--message-file <path>`	Baca pesan dari berkas UTF-8 yang valid
`--to <dest>`	Turunkan kunci sesi dari target (telepon, id obrolan)
`--session-key <key>`	Gunakan kunci sesi eksplisit
`--agent <id>`	Tuju agen yang dikonfigurasi (menggunakan sesi `main`-nya)
`--session-id <id>`	Gunakan kembali sesi yang ada berdasarkan id
`--model <id>`	Penggantian model untuk eksekusi ini (`provider/model` atau id model)
`--local`	Paksa runtime tersemat lokal (lewati Gateway)
`--deliver`	Kirim balasan ke saluran obrolan
`--channel <name>`	Saluran pengiriman; dengan `--agent` + `--to`, juga menerapkan cakupan DM
`--reply-to <target>`	Penggantian target pengiriman
`--reply-channel <name>`	Penggantian saluran pengiriman
`--reply-account <id>`	Penggantian id akun pengiriman
`--thinking <level>`	Atur tingkat pemikiran untuk profil model yang dipilih
`--verbose <on\|full\|off>`	Pertahankan tingkat verbositas untuk sesi (`full` juga mencatat keluaran alat)
`--timeout <seconds>`	Ganti batas waktu agen (bawaan 600, atau nilai konfigurasi)
`--json`	Keluarkan JSON terstruktur

Perilaku

Secara bawaan, CLI berjalan melalui Gateway. Tambahkan --local untuk memaksa runtime tersemat pada mesin saat ini.
Teruskan tepat salah satu dari --message atau --message-file. Pesan berkas mempertahankan konten multibaris setelah menghapus BOM UTF-8 opsional.
Jika permintaan Gateway gagal, CLI beralih kembali ke eksekusi tersemat lokal; batas waktu Gateway beralih kembali dengan sesi baru alih-alih berpacu dengan transkrip asli.
Pemilihan sesi: --to menurunkan kunci sesi (target grup/saluran mempertahankan isolasi; obrolan langsung disatukan ke main). Saat --agent, --channel, dan --to digunakan bersama, perutean mengikuti penerima kanonis saluran dan session.dmScope. Identitas stabil khusus keluar menggunakan sesi milik penyedia yang diisolasi dari sesi utama agen.
--session-key memilih kunci eksplisit. Kunci berawalan agen harus menggunakan agent:<agent-id>:<session-key>, dan --agent harus cocok dengan id agen tersebut saat keduanya diberikan. Kunci polos non-sentinel dicakupkan ke --agent jika diberikan; misalnya, --agent ops --session-key incident-42 dirutekan ke agent:ops:incident-42. Tanpa --agent, kunci polos non-sentinel dicakupkan ke agen bawaan yang dikonfigurasi. Literal global dan unknown tetap tanpa cakupan hanya saat --agent tidak diberikan; jalur peralihan tersemat menyelesaikan sesi sentinel tersebut ke agen bawaan yang dikonfigurasi.
--reply-channel dan --reply-account hanya memengaruhi pengiriman.
Tanda pemikiran dan verbositas dipertahankan ke penyimpanan sesi.
Keluaran: teks biasa secara bawaan, atau --json untuk muatan terstruktur + metadata.
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 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"