Di halaman ini
Di halaman ini
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
| 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.
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. |
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). |
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. |
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. |