Langsung ke konten utama
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

1

Jalankan giliran agen sederhana

openclaw agent --agent main --message "What is the weather today?"
Ini mengirim pesan melalui Gateway dan mencetak balasannya.
2

Kirim prompt multibaris dari file

openclaw agent --agent ops --message-file ./task.md
Ini membaca file UTF-8 yang valid sebagai isi pesan agen.
3

Targetkan agen atau sesi tertentu

# Target a specific agent
openclaw agent --agent ops --message "Summarize logs"

# Target a phone number (derives session key)
openclaw agent --to +15555550123 --message "Status update"

# Reuse an existing session
openclaw agent --session-id abc123 --message "Continue the task"

# Target an exact session key
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"
4

Kirimkan balasan ke channel

# Deliver to WhatsApp (default channel)
openclaw agent --to +15555550123 --message "Report ready" --deliver

# Deliver to Slack
openclaw agent --agent ops --message "Generate report" \
  --deliver --reply-channel slack --reply-to "#reports"

​
Flag

FlagDeskripsi
--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
--localPaksa runtime tertanam lokal (lewati Gateway)
--deliverKirim 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
--jsonKeluarkan 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

# Simple turn with JSON output
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json

# Turn with thinking level
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium

# Multiline prompt from a file
openclaw agent --agent ops --message-file ./task.md

# Exact session key
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

# Legacy key scoped to an agent
openclaw agent --agent ops --session-key incident-42 --message "Summarize status"

# Deliver to a different channel than the session
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

​
Terkait

Referensi CLI agen

Referensi lengkap flag dan opsi openclaw agent.

Sub-agen

Peluncuran sub-agen latar belakang.

Sesi

Cara kerja kunci sesi dan cara --to, --agent, dan --session-id menyelesaikannya.

Perintah slash

Katalog perintah native yang digunakan di dalam sesi agen.