--- read_when: - Anda menggunakan plugin panggilan suara dan menginginkan setiap titik masuk CLI - Anda memerlukan tabel flag dan nilai default untuk setup, smoke, call, continue, speak, dtmf, end, status, tail, latency, expose, dan start summary: Referensi CLI untuk `openclaw voicecall` (antarmuka perintah plugin panggilan suara) title: Panggilan suara x-i18n: generated_at: "2026-07-12T14:03:41Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: aec445886cccb79c9212dd9f1f448ff9634274deb380632be786478c9bb29670 source_path: cli/voicecall.md workflow: 16 --- # `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 ] [--message ] [--mode ] [--yes] [--json] openclaw voicecall call -m [-t ] [--mode ] openclaw voicecall start --to [--message ] [--mode ] openclaw voicecall continue --call-id --message openclaw voicecall speak --call-id --message openclaw voicecall dtmf --call-id --digits openclaw voicecall end --call-id openclaw voicecall status [--call-id ] [--json] openclaw voicecall tail [--file ] [--since ] [--poll ] openclaw voicecall latency [--file ] [--last ] openclaw voicecall expose [--mode ] [--path

] [--port ] [--serve-path

] ``` | 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 setup openclaw voicecall setup --json ``` ### `smoke` Menjalankan pemeriksaan kesiapan yang sama. Melakukan panggilan telepon sungguhan hanya saat `--to` dan `--yes` diberikan. | Flag | Default | Deskripsi | | ------------------ | --------------------------------- | ---------------------------------------------- | | `-t, --to ` | (tidak ada) | Nomor telepon yang akan dipanggil untuk uji cepat langsung. | | `--message ` | `OpenClaw voice call smoke test.` | Pesan yang diucapkan selama panggilan uji cepat. | | `--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 smoke openclaw voicecall smoke --to "+15555550123" # simulasi openclaw voicecall smoke --to "+15555550123" --yes # panggilan notifikasi langsung ``` Untuk penyedia eksternal (`plivo`, `telnyx`, `twilio`), `setup` dan `smoke` memerlukan URL Webhook publik dari `publicUrl`, sebuah tunnel, atau eksposur Tailscale. Fallback serve loopback atau privat ditolak karena operator telekomunikasi tidak dapat menjangkaunya. ## Siklus hidup panggilan ### `call` Memulai panggilan suara keluar. | Flag | Wajib | Default | Deskripsi | | ---------------------- | ----- | ----------------- | -------------------------------------------------------------------------- | | `-m, --message ` | ya | (tidak ada) | Pesan yang diucapkan saat panggilan tersambung. | | `-t, --to ` | tidak | config `toNumber` | Nomor telepon E.164 yang akan dipanggil. | | `--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 ` | ya | (tidak ada) | Nomor telepon yang akan dipanggil. | | `--message ` | tidak | (tidak ada) | Pesan yang diucapkan saat panggilan tersambung. | | `--mode ` | tidak | `conversation` | Mode panggilan: `notify` atau `conversation`. | ### `continue` Mengucapkan pesan dan menunggu respons. | Flag | Wajib | Deskripsi | | ------------------ | ----- | -------------------- | | `--call-id ` | ya | ID panggilan. | | `--message ` | ya | Pesan yang diucapkan. | ### `speak` Mengucapkan pesan tanpa menunggu respons. | Flag | Wajib | Deskripsi | | ------------------ | ----- | -------------------- | | `--call-id ` | ya | ID panggilan. | | `--message ` | ya | Pesan yang diucapkan. | ### `dtmf` Mengirim digit DTMF ke panggilan aktif. | Flag | Wajib | Deskripsi | | ------------------- | ----- | ------------------------------------------------------- | | `--call-id ` | ya | ID panggilan. | | `--digits ` | ya | Digit DTMF (misalnya `ww123456#` untuk jeda tunggu). | ### `end` Mengakhiri panggilan aktif. | Flag | Wajib | Deskripsi | | ---------------- | ----- | ------------- | | `--call-id ` | ya | ID panggilan. | ### `status` Memeriksa panggilan aktif. | Flag | Default | Deskripsi | | ---------------- | ----------- | ---------------------------------------- | | `--call-id ` | (tidak ada) | Membatasi keluaran ke satu panggilan. | | `--json` | `false` | Mencetak JSON yang dapat dibaca mesin. | ```bash openclaw voicecall status openclaw voicecall status --json openclaw voicecall status --call-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 ` | ditentukan dari penyimpanan Plugin | Jalur ke `calls.jsonl`. | | `--since ` | `25` | Jumlah baris yang dicetak sebelum mengikuti. | | `--poll ` | `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 ` | ditentukan dari penyimpanan Plugin | Jalur ke `calls.jsonl`. | | `--last ` | `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 ` | `funnel` | `off`, `serve` (tailnet), atau `funnel` (publik). | | `--path ` | config `tailscale.path` atau `--serve-path` | Jalur Tailscale yang akan diekspos. | | `--port ` | config `serve.port` atau `3334` | Port Webhook lokal. | | `--serve-path ` | config `serve.path` atau `/voice/webhook` | Jalur Webhook lokal. | ```bash openclaw voicecall expose --mode serve openclaw voicecall expose --mode funnel openclaw voicecall expose --mode off ``` Hanya ekspos endpoint Webhook ke jaringan yang Anda percayai. Utamakan Tailscale Serve daripada Funnel jika memungkinkan. ## Terkait - [Referensi CLI](/id/cli) - [Plugin panggilan suara](/id/plugins/voice-call)