OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

Panggilan suara

openclaw voicecall

voicecall adalah perintah yang disediakan oleh Plugin. Perintah ini hanya muncul saat Plugin panggilan suara terinstal dan diaktifkan.

Saat Gateway berjalan, perintah operasional (call, start, continue, speak, dtmf, end, status) dirutekan ke runtime panggilan suara Gateway tersebut. Jika tidak ada Gateway yang dapat dijangkau, perintah tersebut beralih ke runtime CLI mandiri.

Subperintah

bash
openclaw voicecall setup    [--json]openclaw voicecall smoke    [-t <phone>] [--message <text>] [--mode <m>] [--yes] [--json]openclaw voicecall call     -m <text> [-t <phone>] [--mode <m>]openclaw voicecall start    --to <phone> [--message <text>] [--mode <m>]openclaw voicecall continue --call-id <id> --message <text>openclaw voicecall speak    --call-id <id> --message <text>openclaw voicecall dtmf     --call-id <id> --digits <digits>openclaw voicecall end      --call-id <id>openclaw voicecall status   [--call-id <id>] [--json]openclaw voicecall tail     [--file <path>] [--since <n>] [--poll <ms>]openclaw voicecall latency  [--file <path>] [--last <n>]openclaw voicecall expose   [--mode <m>] [--path <p>] [--port <port>] [--serve-path <p>]
Subperintah Deskripsi
setup Menampilkan pemeriksaan kesiapan penyedia dan Webhook.
smoke Menjalankan pemeriksaan kesiapan; melakukan panggilan uji langsung hanya dengan --yes.
call Memulai panggilan suara keluar.
start Alias untuk call dengan --to wajib dan --message opsional.
continue Mengucapkan pesan dan menunggu respons berikutnya.
speak Mengucapkan pesan tanpa menunggu respons.
dtmf Mengirim digit DTMF ke panggilan aktif.
end Mengakhiri panggilan aktif.
status Memeriksa panggilan aktif (atau satu panggilan berdasarkan --call-id).
tail Mengikuti calls.jsonl (berguna selama pengujian penyedia).
latency Merangkum metrik latensi giliran dari calls.jsonl.
expose Mengalihkan Tailscale serve/funnel untuk endpoint Webhook.

Penyiapan dan uji cepat

setup

Secara default, mencetak pemeriksaan kesiapan yang mudah dibaca manusia. Berikan --json untuk skrip.

bash
openclaw voicecall setupopenclaw voicecall setup --json

smoke

Menjalankan pemeriksaan kesiapan yang sama. Melakukan panggilan telepon sungguhan hanya saat --to dan --yes diberikan.

Flag Default Deskripsi
-t, --to <phone> (tidak ada) Nomor telepon yang akan dipanggil untuk uji cepat langsung.
--message <text> OpenClaw voice call smoke test. Pesan yang diucapkan selama panggilan uji cepat.
--mode <mode> notify Mode panggilan: notify atau conversation.
--yes false Benar-benar melakukan panggilan keluar langsung.
--json false Mencetak JSON yang dapat dibaca mesin.
bash
openclaw voicecall smokeopenclaw voicecall smoke --to "+15555550123"        # simulasiopenclaw voicecall smoke --to "+15555550123" --yes  # panggilan notifikasi langsung

Siklus hidup panggilan

call

Memulai panggilan suara keluar.

Flag Wajib Default Deskripsi
-m, --message <text> ya (tidak ada) Pesan yang diucapkan saat panggilan tersambung.
-t, --to <phone> tidak config toNumber Nomor telepon E.164 yang akan dipanggil.
--mode <mode> tidak conversation Mode panggilan: notify (akhiri setelah pesan) atau conversation (tetap tersambung).
bash
openclaw voicecall call --to "+15555550123" --message "Hello"openclaw voicecall call -m "Heads up" --mode notify

start

Alias untuk call dengan bentuk flag default yang berbeda.

Flag Wajib Default Deskripsi
--to <phone> ya (tidak ada) Nomor telepon yang akan dipanggil.
--message <text> tidak (tidak ada) Pesan yang diucapkan saat panggilan tersambung.
--mode <mode> tidak conversation Mode panggilan: notify atau conversation.

continue

Mengucapkan pesan dan menunggu respons.

Flag Wajib Deskripsi
--call-id <id> ya ID panggilan.
--message <text> ya Pesan yang diucapkan.

speak

Mengucapkan pesan tanpa menunggu respons.

Flag Wajib Deskripsi
--call-id <id> ya ID panggilan.
--message <text> ya Pesan yang diucapkan.

dtmf

Mengirim digit DTMF ke panggilan aktif.

Flag Wajib Deskripsi
--call-id <id> ya ID panggilan.
--digits <digits> ya Digit DTMF (misalnya ww123456# untuk jeda tunggu).

end

Mengakhiri panggilan aktif.

Flag Wajib Deskripsi
--call-id <id> ya ID panggilan.

status

Memeriksa panggilan aktif.

Flag Default Deskripsi
--call-id <id> (tidak ada) Membatasi keluaran ke satu panggilan.
--json false Mencetak JSON yang dapat dibaca mesin.
bash
openclaw voicecall statusopenclaw voicecall status --jsonopenclaw voicecall status --call-id <id>

Log dan metrik

tail

Mengikuti log JSONL panggilan suara. Mencetak sejumlah baris terakhir sesuai --since saat dimulai, lalu mengalirkan baris baru ketika ditulis.

Flag Default Deskripsi
--file <path> ditentukan dari penyimpanan Plugin Jalur ke calls.jsonl.
--since <n> 25 Jumlah baris yang dicetak sebelum mengikuti.
--poll <ms> 250 (minimum 50) Interval polling dalam milidetik.

latency

Merangkum metrik latensi giliran dan waktu tunggu mendengarkan dari calls.jsonl. Keluarannya berupa JSON dengan ringkasan recordsScanned, turnLatency, dan listenWait.

Flag Default Deskripsi
--file <path> ditentukan dari penyimpanan Plugin Jalur ke calls.jsonl.
--last <n> 200 (minimum 1) Jumlah rekaman terbaru yang akan dianalisis.

Mengekspos Webhook

expose

Mengaktifkan, menonaktifkan, atau mengubah konfigurasi Tailscale serve/funnel untuk Webhook suara.

Flag Default Deskripsi
--mode <mode> funnel off, serve (tailnet), atau funnel (publik).
--path <path> config tailscale.path atau --serve-path Jalur Tailscale yang akan diekspos.
--port <port> config serve.port atau 3334 Port Webhook lokal.
--serve-path <path> config serve.path atau /voice/webhook Jalur Webhook lokal.
bash
openclaw voicecall expose --mode serveopenclaw voicecall expose --mode funnelopenclaw voicecall expose --mode off

Terkait

Was this useful?
On this page

On this page