Pengiriman agen

​

Mulai cepat

openclaw agent --agent main --message "Bagaimana cuaca hari ini?"

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

# Targetkan agen tertentu
openclaw agent --agent ops --message "Ringkas log"

# Targetkan nomor telepon (menghasilkan kunci sesi)
openclaw agent --to +15555550123 --message "Pembaruan status"

# Gunakan kembali sesi yang ada
openclaw agent --session-id abc123 --message "Lanjutkan tugas"

# Targetkan kunci sesi yang persis
openclaw agent --session-key agent:ops:incident-42 --message "Ringkas status"

# Kirim ke WhatsApp (saluran default)
openclaw agent --to +15555550123 --message "Laporan siap" --deliver

# Kirim ke Slack
openclaw agent --agent ops --message "Buat laporan" \
  --deliver --reply-channel slack --reply-to "#reports"

​

Flag

​

Perilaku

• Secara default, CLI berjalan melalui Gateway. Tambahkan --local untuk memaksa runtime tertanam pada mesin saat ini.
• Berikan tepat salah satu dari --message atau --message-file. Pesan file mempertahankan konten multibaris setelah menghapus BOM UTF-8 opsional. File yang lebih besar dari 4 MiB ditolak sebelum dikirim.
• Setelah percobaan ulang handshake sementara, batas waktu Gateway atau koneksi yang ditutup menyebabkan perintah gagal dengan petunjuk di stderr; CLI tidak pernah secara diam-diam menjalankan ulang giliran secara tertanam. Gateway mungkin masih menyelesaikan giliran yang diterima, jadi verifikasi status Gateway dan sesi sebelum mencoba lagi atau menjalankan ulang dengan --local.
• Pemilihan sesi: --to menghasilkan kunci sesi (target grup/saluran mempertahankan isolasi; chat langsung disatukan menjadi main). Saat --agent, --channel, dan --to digunakan bersama-sama, perutean mengikuti penerima kanonis saluran dan session.dmScope. Identitas stabil yang hanya untuk keluar menggunakan sesi milik penyedia yang terisolasi 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 biasa non-sentinel dicakup ke --agent saat diberikan; misalnya, --agent ops --session-key incident-42 dirutekan ke agent:ops:incident-42. Tanpa --agent, kunci biasa non-sentinel dicakup ke agen default yang dikonfigurasi. Nilai literal global dan unknown tetap tidak dicakup hanya ketika --agent tidak diberikan.
• --reply-channel dan --reply-account hanya memengaruhi pengiriman.
• Flag pemikiran dan verbositas disimpan secara persisten ke penyimpanan sesi.
• Output: teks biasa secara default, atau --json untuk payload terstruktur + metadata.
• Dengan --json --deliver, JSON menyertakan status pengiriman untuk pengiriman yang terkirim, dicegah, parsial, dan gagal. Lihat Status pengiriman JSON.

​

Contoh

# Giliran sederhana dengan output JSON
openclaw agent --to +15555550123 --message "Telusuri log" --verbose on --json

# Giliran dengan penggantian model
openclaw agent --agent ops --model openai/gpt-5.4 --message "Ringkas log"

# Giliran dengan tingkat pemikiran
openclaw agent --session-id 1234 --message "Ringkas kotak masuk" --thinking medium

# Prompt multibaris dari file
openclaw agent --agent ops --message-file ./task.md

# Kunci sesi yang persis
openclaw agent --session-key agent:ops:incident-42 --message "Ringkas status"

# Kunci lama yang dicakup ke agen
openclaw agent --agent ops --session-key incident-42 --message "Ringkas status"

# Kirim ke saluran yang berbeda dari sesi
openclaw agent --agent ops --message "Peringatan" --deliver --reply-channel telegram --reply-to "@admin"

​

Terkait