Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 --message "What is the weather today?"
Ini mengirim pesan melalui Gateway dan mencetak balasannya.
2

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

Kirim balasan ke kanal

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

​
Opsi

OpsiDeskripsi
--message \<text\>Pesan yang akan dikirim (wajib)
--to \<dest\>Turunkan kunci sesi dari target (telepon, id chat)
--agent \<id\>Targetkan agen yang dikonfigurasi (menggunakan sesi main)
--session-id \<id\>Gunakan kembali sesi yang sudah ada berdasarkan id
--localPaksa runtime tertanam lokal (lewati Gateway)
--deliverKirim balasan ke kanal chat
--channel \<name\>Kanal pengiriman (whatsapp, telegram, discord, slack, dll.)
--reply-to \<target\>Override target pengiriman
--reply-channel \<name\>Override kanal pengiriman
--reply-account \<id\>Override id akun pengiriman
--thinking \<level\>Atur level berpikir untuk profil model yang dipilih
--verbose \<on|full|off\>Atur level verbose
--timeout \<seconds\>Override batas waktu agen
--jsonKeluarkan JSON terstruktur

​
Perilaku

  • Secara default, CLI berjalan melalui Gateway. Tambahkan --local untuk memaksa runtime tertanam pada mesin saat ini.
  • Jika Gateway tidak dapat dijangkau, CLI fallback ke eksekusi tertanam lokal.
  • Pemilihan sesi: --to menurunkan kunci sesi (target grup/kanal mempertahankan isolasi; chat langsung digabungkan ke main).
  • Flag thinking dan verbose dipertahankan ke dalam penyimpanan sesi.
  • Output: teks biasa secara default, atau --json untuk payload + metadata terstruktur.
  • Dengan --json --deliver, JSON menyertakan status pengiriman untuk pengiriman terkirim, disupresi, 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

# 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

Pembuatan 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.