Plugin panggilan suara

Panggilan suara untuk OpenClaw melalui plugin: notifikasi keluar, percakapan multi-giliran, suara waktu nyata dupleks penuh, transkripsi streaming, dan panggilan masuk dengan kebijakan daftar izin.

Penyedia: mock (pengembangan, tanpa jaringan), plivo (API Suara + transfer XML + ucapan GetInput), telnyx (Call Control v2), twilio (Suara Terprogram + Media Streams).

Mulai cepat

openclaw plugins install @openclaw/voice-call

PLUGIN_SRC=./path/to/local/voice-call-pluginopenclaw plugins install "$PLUGIN_SRC"cd "$PLUGIN_SRC" && pnpm install

openclaw voicecall setupopenclaw voicecall setup --json

openclaw voicecall smokeopenclaw voicecall smoke --to "+15555550123"

openclaw voicecall smoke --to "+15555550123" --yes

Konfigurasi

Jika enabled: true tetapi penyedia yang dipilih tidak memiliki kredensial, proses awal Gateway mencatat peringatan penyiapan belum lengkap beserta kunci yang hilang dan melewati inisialisasi runtime. Perintah, panggilan RPC, dan alat agen tetap mengembalikan konfigurasi tepat yang hilang saat digunakan.

{  plugins: {    entries: {      "voice-call": {        enabled: true,        config: {          provider: "twilio", // atau "telnyx" | "plivo" | "mock"          fromNumber: "+15550001234", // atau TWILIO_FROM_NUMBER untuk Twilio          toNumber: "+15550005678",          sessionScope: "per-phone", // per-phone | per-call          numbers: {            "+15550009999": {              inboundGreeting: "Silver Fox Cards, ada yang bisa saya bantu?",              responseSystemPrompt: "Anda adalah spesialis kartu bisbol yang ringkas.",              tts: {                providers: {                  openai: { speakerVoice: "alloy" },                },              },            },          },           twilio: {            accountSid: "ACxxxxxxxx",            authToken: "...",            // region: "ie1", // opsional: us1 | ie1 | au1; default-nya us1          },          telnyx: {            apiKey: "...",            connectionId: "...",            // Kunci publik webhook Telnyx dari Mission Control Portal            // (Base64; juga dapat diatur melalui TELNYX_PUBLIC_KEY).            publicKey: "...",          },          plivo: {            authId: "MAxxxxxxxxxxxxxxxxxxxx",            authToken: "...",          },           // Server webhook          serve: {            port: 3334,            path: "/voice/webhook",          },           // Keamanan webhook (direkomendasikan untuk tunnel/proksi)          webhookSecurity: {            allowedHosts: ["voice.example.com"],            trustedProxyIPs: ["100.64.0.1"],          },           // Eksposur publik (pilih satu)          // publicUrl: "https://example.ngrok.app/voice/webhook",          // tunnel: { provider: "ngrok" },          // tailscale: { mode: "funnel", path: "/voice/webhook" },           outbound: {            defaultMode: "notify", // notify | conversation          },           streaming: { enabled: true /* khusus Twilio; lihat Transkripsi streaming */ },          realtime: { enabled: false /* lihat Percakapan suara waktu nyata */ },        },      },    },  },}

Referensi konfigurasi

Kunci tingkat atas di bawah plugins.entries.voice-call.config yang tidak ditampilkan di atas:

Twilio secara default menggunakan endpoint REST US1-nya. Untuk memproses panggilan di Wilayah non-AS yang didukung, atur twilio.region ke ie1 atau au1 dan gunakan kredensial dari Wilayah tersebut. Lihat panduan REST API non-AS Twilio.

Cakupan sesi

Secara default, Panggilan Suara menggunakan sessionScope: "per-phone" sehingga panggilan berulang dari penelepon yang sama mempertahankan memori percakapan. Atur sessionScope: "per-call" ketika setiap panggilan operator harus dimulai dengan konteks baru, misalnya alur resepsionis, pemesanan, IVR, atau jembatan Google Meet, saat nomor telepon yang sama dapat mewakili rapat yang berbeda.

Panggilan Suara menyimpan kunci sesi yang dihasilkan di bawah namespace agen yang dikonfigurasi (agent:<agentId>:voice:*). Kunci integrasi eksplisit mentah diselesaikan ke dalam namespace yang sama: kunci agent:<configuredAgentId>:* kanonis mempertahankan pemilik tersebut dan mematuhi alias cakupan global/session.mainKey inti; masukan agent:* asing atau cacat dicakup sebagai kunci opak di bawah agen yang dikonfigurasi; global dan unknown tetap menjadi sentinel global.

Percakapan suara waktu nyata

realtime memilih penyedia suara waktu nyata dupleks penuh untuk audio panggilan langsung. Ini terpisah dari streaming, yang hanya meneruskan audio ke penyedia transkripsi waktu nyata.

Perilaku runtime saat ini:

• realtime.enabled didukung untuk Twilio dan Telnyx.
• realtime.provider bersifat opsional. Jika tidak diatur, Voice Call menggunakan penyedia suara waktu nyata pertama yang terdaftar.
• Penyedia suara waktu nyata bawaan: Google Gemini Live (google) dan OpenAI (openai), yang didaftarkan oleh plugin penyedianya.
• Konfigurasi mentah milik penyedia berada di bawah realtime.providers.<providerId>.
• Voice Call menyediakan alat waktu nyata bersama openclaw_agent_consult secara default. Model waktu nyata dapat memanggilnya ketika penelepon meminta penalaran yang lebih mendalam, informasi terkini, atau alat OpenClaw biasa.
• realtime.consultPolicy secara opsional menambahkan panduan mengenai kapan model waktu nyata harus memanggil openclaw_agent_consult.
• realtime.agentContext.enabled dinonaktifkan secara default. Saat diaktifkan, Voice Call menyisipkan identitas agen yang dibatasi dan kapsul file ruang kerja terpilih ke dalam instruksi penyedia waktu nyata saat penyiapan sesi.
• realtime.fastContext.enabled dinonaktifkan secara default. Saat diaktifkan, Voice Call terlebih dahulu mencari konteks memori/sesi yang telah diindeks untuk pertanyaan konsultasi dan mengembalikan cuplikan tersebut kepada model waktu nyata dalam batas realtime.fastContext.timeoutMs, sebelum beralih ke agen konsultasi lengkap hanya jika realtime.fastContext.fallbackToConsult bernilai true.
• Jika realtime.provider mengarah ke penyedia yang tidak terdaftar, atau sama sekali tidak ada penyedia suara waktu nyata yang terdaftar, Voice Call mencatat peringatan dan melewati media waktu nyata alih-alih menggagalkan seluruh plugin.
• inboundPolicy tidak boleh berupa "disabled" ketika realtime.enabled bernilai true; validateProviderConfig menolak kombinasi tersebut.
• Kunci sesi konsultasi menggunakan kembali sesi panggilan tersimpan jika tersedia, lalu beralih ke sessionScope yang dikonfigurasi (per-phone secara default, atau per-call untuk panggilan terisolasi).

Kebijakan alat

realtime.toolPolicy mengendalikan proses konsultasi:

realtime.consultPolicy hanya mengendalikan instruksi model waktu nyata:

Konteks suara agen

Aktifkan realtime.agentContext ketika jembatan suara harus terdengar seperti agen OpenClaw yang dikonfigurasi tanpa menanggung perjalanan bolak-balik konsultasi agen penuh pada interaksi biasa. Kapsul konteks ditambahkan satu kali saat sesi waktu nyata dibuat, sehingga tidak menambah latensi per interaksi. Panggilan ke openclaw_agent_consult tetap menjalankan agen OpenClaw lengkap dan sebaiknya digunakan untuk pekerjaan alat, informasi terkini, pencarian memori, atau status ruang kerja.

{  plugins: {    entries: {      "voice-call": {        config: {          agentId: "main",          realtime: {            enabled: true,            provider: "google",            toolPolicy: "safe-read-only",            consultPolicy: "substantive",            agentContext: {              enabled: true,              maxChars: 6000,              includeIdentity: true,              includeWorkspaceFiles: true,              files: ["SOUL.md", "IDENTITY.md", "USER.md"],            },          },        },      },    },  },}

Contoh penyedia waktu nyata

{  plugins: {    entries: {      "voice-call": {        config: {          provider: "twilio",          inboundPolicy: "allowlist",          allowFrom: ["+15550005678"],          realtime: {            enabled: true,            provider: "google",            instructions: "Bicaralah dengan singkat. Panggil openclaw_agent_consult sebelum menggunakan alat yang lebih mendalam.",            toolPolicy: "safe-read-only",            consultPolicy: "substantive",            consultThinkingLevel: "low",            consultFastMode: true,            agentContext: { enabled: true },            providers: {              google: {                apiKey: "${GEMINI_API_KEY}",                model: "gemini-3.1-flash-live-preview",                speakerVoice: "Kore",                silenceDurationMs: 500,                startSensitivity: "high",              },            },          },        },      },    },  },}

{  plugins: {    entries: {      "voice-call": {        config: {          realtime: {            enabled: true,            provider: "openai",            providers: {              openai: { apiKey: "${OPENAI_API_KEY}" },            },          },        },      },    },  },}

Lihat penyedia Google dan penyedia OpenAI untuk opsi suara waktu nyata khusus penyedia.

Transkripsi streaming

streaming menghubungkan Twilio Media Streams ke penyedia transkripsi waktu nyata. Jalur streaming klasik memerlukan provider: "twilio"; konfigurasi dengan Telnyx, Plivo, atau mock ditolak. Audio langsung Telnyx menggunakan jalur realtime.enabled yang diautentikasi secara terpisah.

Perilaku runtime saat ini:

• streaming.provider bersifat opsional. Jika tidak diatur, Voice Call menggunakan penyedia transkripsi waktu nyata pertama yang terdaftar.
• Penyedia transkripsi waktu nyata bawaan: Deepgram (deepgram), ElevenLabs (elevenlabs), Mistral (mistral), OpenAI (openai), dan xAI (xai), yang didaftarkan oleh plugin penyedianya.
• Konfigurasi mentah milik penyedia berada di bawah streaming.providers.<providerId>.
• Setelah Twilio mengirim pesan stream start yang diterima, Voice Call segera mendaftarkan stream tersebut, mengantrekan media masuk melalui penyedia transkripsi selagi penyedia tersambung, dan memulai sapaan awal hanya setelah transkripsi waktu nyata siap.
• Jika streaming.provider mengarah ke penyedia yang tidak terdaftar, atau tidak ada penyedia yang terdaftar, Voice Call mencatat peringatan dan melewati streaming media alih-alih menggagalkan seluruh plugin.

Contoh penyedia streaming

{  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "openai",            streamPath: "/voice/stream",            providers: {              openai: {                apiKey: "sk-...", // opsional jika OPENAI_API_KEY diatur                model: "gpt-4o-transcribe",                silenceDurationMs: 800,                vadThreshold: 0.5,              },            },          },        },      },    },  },}

{  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "xai",            streamPath: "/voice/stream",            providers: {              xai: {                apiKey: "${XAI_API_KEY}", // opsional jika XAI_API_KEY diatur                endpointingMs: 800,                language: "en",              },            },          },        },      },    },  },}

TTS untuk panggilan

Voice Call menggunakan konfigurasi inti messages.tts untuk ucapan streaming pada panggilan. Anda dapat menggantinya di bawah konfigurasi plugin dengan bentuk yang sama — konfigurasi tersebut digabungkan secara mendalam dengan messages.tts.

{  tts: {    provider: "elevenlabs",    providers: {      elevenlabs: {        speakerVoiceId: "pMsXgVXv3BLzUgSXRplE",        modelId: "eleven_multilingual_v2",      },    },  },}

Catatan perilaku:

• Kunci tts.<provider> lama di dalam konfigurasi plugin (openai, elevenlabs, microsoft, edge) diperbaiki oleh openclaw doctor --fix; konfigurasi yang di-commit harus menggunakan tts.providers.<provider>.
• TTS inti digunakan ketika streaming media Twilio diaktifkan; jika tidak, panggilan beralih ke suara bawaan penyedia.
• Jika stream media Twilio sudah aktif, Voice Call tidak beralih ke OPENCLAW_DOCS_MARKER:calloutOpen:U2F5 TwiML. Jika TTS telepon tidak tersedia dalam keadaan tersebut, permintaan pemutaran akan gagal alih-alih mencampurkan dua jalur pemutaran.
• Ketika TTS telepon beralih ke penyedia sekunder, Voice Call mencatat peringatan beserta rantai penyedia (from, to, attempts) untuk proses debug.
• Ketika interupsi Twilio atau penghentian stream menghapus antrean TTS yang tertunda, permintaan pemutaran dalam antrean diselesaikan alih-alih membuat penelepon yang menunggu penyelesaian pemutaran terus tertahan.

Contoh TTS

{messages: {tts: {provider: "openai",providers: {  openai: { speakerVoice: "alloy" },},},},}

{plugins: {entries: {"voice-call": {  config: {    tts: {      provider: "elevenlabs",      providers: {        elevenlabs: {          apiKey: "elevenlabs_key",          speakerVoiceId: "pMsXgVXv3BLzUgSXRplE",          modelId: "eleven_multilingual_v2",        },      },    },  },},},},}

{plugins: {entries: {"voice-call": {  config: {    tts: {      providers: {        openai: {          model: "gpt-4o-mini-tts",          speakerVoice: "marin",        },      },    },  },},},},}

Panggilan masuk

Kebijakan panggilan masuk secara default adalah disabled. Untuk mengaktifkan panggilan masuk, tetapkan:

{inboundPolicy: "allowlist",allowFrom: ["+15550001234"],inboundGreeting: "Halo! Ada yang bisa saya bantu?",}

Respons otomatis menggunakan sistem agen. Sesuaikan dengan responseModel, responseSystemPrompt, dan responseTimeoutMs.

Perutean per nomor

Gunakan numbers saat satu Plugin Voice Call menerima panggilan untuk beberapa nomor telepon dan setiap nomor harus berperilaku seperti saluran yang berbeda. Misalnya, satu nomor dapat menggunakan asisten pribadi yang santai, sementara nomor lain menggunakan persona bisnis, agen respons yang berbeda, dan suara TTS yang berbeda.

Rute dipilih dari nomor To yang dihubungi dan diberikan oleh penyedia. Kunci harus berupa nomor E.164. Saat panggilan masuk, Voice Call menentukan rute yang cocok satu kali, menyimpan rute yang cocok pada catatan panggilan, dan menggunakan kembali konfigurasi efektif tersebut untuk salam, jalur respons otomatis klasik, jalur konsultasi realtime, dan pemutaran TTS. Jika tidak ada rute yang cocok, konfigurasi Voice Call global akan digunakan. Panggilan keluar tidak menggunakan numbers; teruskan target keluar, pesan, dan sesi secara eksplisit saat memulai panggilan.

Penggantian rute saat ini mendukung:

• inboundGreeting
• tts
• agentId
• responseModel
• responseSystemPrompt
• responseTimeoutMs

Nilai rute tts di-deep-merge ke atas konfigurasi tts Voice Call global, sehingga Anda biasanya cukup mengganti suara penyedia:

{inboundGreeting: "Halo dari saluran utama.",responseSystemPrompt: "Anda adalah asisten suara default.",tts: {  provider: "openai",  providers: {    openai: { speakerVoice: "coral" },  },},numbers: {  "+15550001111": {    inboundGreeting: "Silver Fox Cards, ada yang bisa saya bantu?",    responseSystemPrompt: "Anda adalah spesialis kartu bisbol yang ringkas.",    tts: {      providers: {        openai: { speakerVoice: "alloy" },      },    },  },},}

Kontrak keluaran lisan

Untuk respons otomatis, Voice Call menambahkan kontrak keluaran lisan yang ketat ke prompt sistem yang mewajibkan balasan JSON {"spoken":"..."}. Voice Call mengekstrak teks ucapan secara defensif:

• Mengabaikan muatan yang ditandai sebagai konten penalaran/kesalahan.
• Mengurai JSON langsung, JSON berpagar, atau kunci "spoken" sebaris.
• Menggunakan teks biasa sebagai cadangan dan menghapus paragraf pembuka yang kemungkinan berisi perencanaan/meta.

Hal ini menjaga agar pemutaran lisan tetap berfokus pada teks yang ditujukan kepada penelepon dan mencegah teks perencanaan bocor ke audio.

Perilaku awal percakapan

Untuk panggilan conversation keluar, penanganan pesan pertama terikat pada status pemutaran langsung:

• Pengosongan antrean saat interupsi dan respons otomatis hanya ditekan selama salam awal sedang aktif diucapkan.
• Jika pemutaran awal gagal, panggilan kembali ke listening dan pesan awal tetap dalam antrean untuk dicoba kembali.
• Pemutaran awal untuk streaming Twilio dimulai saat stream tersambung tanpa penundaan tambahan.
• Interupsi membatalkan pemutaran aktif dan menghapus entri TTS Twilio yang sudah mengantre tetapi belum diputar. Entri yang dihapus diselesaikan sebagai dilewati, sehingga logika respons lanjutan dapat diteruskan tanpa menunggu audio yang tidak akan pernah diputar.
• Percakapan suara realtime menggunakan giliran pembuka milik stream realtime itu sendiri. Voice Call tidak mengirim pembaruan TwiML OPENCLAW_DOCS_MARKER:calloutOpen:U2F5 lama untuk pesan awal tersebut, sehingga sesi <Connect><Stream> keluar tetap terhubung.

Masa tenggang pemutusan stream Twilio

Saat stream media Twilio terputus, Voice Call menunggu 2000 ms sebelum mengakhiri panggilan secara otomatis:

• Jika stream tersambung kembali selama jangka waktu tersebut, pengakhiran otomatis dibatalkan.
• Jika tidak ada stream yang didaftarkan kembali setelah masa tenggang, panggilan diakhiri untuk mencegah panggilan aktif macet.

Pembersih panggilan kedaluwarsa

Gunakan staleCallReaperSeconds (default 120) untuk mengakhiri panggilan yang tidak pernah dijawab dan tidak pernah mencapai status percakapan langsung, misalnya panggilan mode notifikasi ketika penyedia tidak pernah mengirimkan Webhook terminal. Tetapkan ke 0 untuk menonaktifkannya.

Pembersih berjalan setiap 30 detik dan hanya mengakhiri panggilan yang tidak memiliki stempel waktu answeredAt serta belum berada dalam status terminal atau langsung (speaking/listening), sehingga percakapan yang telah dijawab tidak pernah dibersihkan oleh pewaktu ini; maxDurationSeconds (default 300) adalah batas terpisah yang mengakhiri panggilan terjawab yang berlangsung terlalu lama.

Untuk alur bergaya notifikasi ketika operator dapat lambat mengirimkan Webhook dering/jawab, naikkan staleCallReaperSeconds melebihi nilai default agar panggilan yang lambat tetapi normal tidak dibersihkan terlalu dini; 120-300 detik merupakan rentang produksi yang wajar.

{plugins: {entries: {  "voice-call": {    config: {      maxDurationSeconds: 300,      staleCallReaperSeconds: 120,    },  },},},}

Keamanan Webhook

Saat proksi atau tunnel berada di depan Gateway, Plugin merekonstruksi URL publik untuk verifikasi tanda tangan. Opsi berikut mengontrol header yang diteruskan dan dipercaya:

Perlindungan tambahan:

• Perlindungan pemutaran ulang Webhook diaktifkan untuk Twilio, Telnyx, dan Plivo. Permintaan Webhook valid yang diputar ulang dikonfirmasi tetapi dilewati untuk efek samping.
• Giliran percakapan Twilio menyertakan token per giliran dalam callback <Gather>, sehingga callback ucapan yang kedaluwarsa/diputar ulang tidak dapat memenuhi giliran transkrip tertunda yang lebih baru.
• Permintaan Webhook yang tidak diautentikasi ditolak sebelum isi dibaca saat header tanda tangan yang diwajibkan penyedia tidak ada.
• Webhook voice-call menggunakan profil pembacaan isi pra-autentikasi bersama (ukuran isi maksimum 64 KB, batas waktu baca 5 detik) ditambah batas permintaan berjalan per kunci (8 permintaan bersamaan per kunci secara default) sebelum verifikasi tanda tangan.

Contoh dengan host publik yang stabil:

{plugins: {entries: {  "voice-call": {    config: {      publicUrl: "https://voice.example.com/voice/webhook",      webhookSecurity: {        allowedHosts: ["voice.example.com"],      },    },  },},},}

CLI

openclaw voicecall call --to "+15555550123" --message "Halo dari OpenClaw"openclaw voicecall start --to "+15555550123"   # alias untuk callopenclaw voicecall continue --call-id <id> --message "Ada pertanyaan?"openclaw voicecall speak --call-id <id> --message "Tunggu sebentar"openclaw voicecall dtmf --call-id <id> --digits "ww123456#"openclaw voicecall end --call-id <id>openclaw voicecall status --call-id <id>openclaw voicecall tailopenclaw voicecall latency                      # meringkas latensi giliran dari logopenclaw voicecall expose --mode funnel

Saat Gateway sudah berjalan, perintah operasional voicecall mendelegasikan ke runtime voice-call milik Gateway agar CLI tidak mengikat server Webhook kedua. Jika tidak ada Gateway yang dapat dijangkau, perintah akan menggunakan runtime CLI mandiri sebagai cadangan.

latency membaca calls.jsonl dari jalur penyimpanan voice-call default. Gunakan --file <path> untuk menunjuk ke log yang berbeda dan --last <n> untuk membatasi analisis pada N catatan terakhir (default 200). Keluaran mencakup min/maks/rata-rata, p50, dan p95 untuk latensi giliran dan waktu tunggu mendengarkan.

Alat agen

Nama alat: voice_call.

Plugin voice-call menyertakan skill agen yang sesuai.

RPC Gateway

dtmfSequence hanya valid dengan mode: "conversation"; panggilan mode notifikasi harus menggunakan voicecall.dtmf setelah panggilan tersedia jika memerlukan digit setelah tersambung.

Pemecahan masalah

Penyiapan gagal mengekspos Webhook

Jalankan penyiapan dari lingkungan yang sama dengan tempat Gateway berjalan:

openclaw voicecall setupopenclaw voicecall setup --json

Untuk twilio, telnyx, dan plivo, webhook-exposure harus berstatus hijau. publicUrl yang telah dikonfigurasi tetap gagal jika mengarah ke ruang jaringan lokal atau privat, karena operator tidak dapat melakukan panggilan balik ke alamat tersebut. Jangan gunakan localhost, 127.0.0.1, 0.0.0.0, 10.x, 172.16.x-172.31.x, 192.168.x, 169.254.x, fc00::/7, fd00::/8, atau rentang NAT tingkat operator lainnya sebagai publicUrl.

Panggilan keluar mode notifikasi Twilio mengirim TwiML OPENCLAW_DOCS_MARKER:calloutOpen:U2F5 awalnya secara langsung dalam permintaan pembuatan panggilan, sehingga pesan lisan pertama tidak bergantung pada Twilio yang mengambil TwiML Webhook. Webhook publik tetap diperlukan untuk callback status, panggilan percakapan, DTMF sebelum tersambung, aliran waktu nyata, dan kontrol panggilan setelah tersambung.

Gunakan satu jalur eksposur publik:

{plugins: {entries: {"voice-call": {  config: {    publicUrl: "https://voice.example.com/voice/webhook",    // atau    tunnel: { provider: "ngrok" },    // atau    tailscale: { mode: "funnel", path: "/voice/webhook" },  },},},},}

Setelah mengubah konfigurasi, mulai ulang atau muat ulang Gateway, lalu jalankan:

openclaw voicecall setupopenclaw voicecall smoke

voicecall smoke adalah uji coba tanpa eksekusi kecuali Anda memberikan --yes.

Kredensial penyedia gagal

Periksa penyedia yang dipilih dan bidang kredensial yang diwajibkan:

• Twilio: twilio.accountSid, twilio.authToken, dan fromNumber, atau TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, dan TWILIO_FROM_NUMBER.
• Telnyx: telnyx.apiKey, telnyx.connectionId, telnyx.publicKey, dan fromNumber, atau TELNYX_API_KEY, TELNYX_CONNECTION_ID, dan TELNYX_PUBLIC_KEY.
• Plivo: plivo.authId, plivo.authToken, dan fromNumber, atau PLIVO_AUTH_ID dan PLIVO_AUTH_TOKEN.

Kredensial harus tersedia di host Gateway. Mengedit profil shell lokal tidak memengaruhi Gateway yang sudah berjalan hingga Gateway dimulai ulang atau memuat ulang lingkungannya.

Panggilan dimulai, tetapi Webhook penyedia tidak diterima

Pastikan konsol penyedia mengarah ke URL Webhook publik yang tepat:

https://voice.example.com/voice/webhook

Kemudian periksa status runtime:

openclaw voicecall status --call-id <id>openclaw voicecall tailopenclaw logs --follow

Penyebab umum:

• publicUrl mengarah ke jalur yang berbeda dari serve.path.
• URL tunnel berubah setelah Gateway dimulai.
• Proksi meneruskan permintaan, tetapi menghapus atau menulis ulang header host/proto.
• Firewall atau DNS merutekan nama host publik ke lokasi selain Gateway.
• Gateway dimulai ulang tanpa mengaktifkan Plugin Voice Call.

Saat proksi terbalik atau tunnel berada di depan Gateway, atur webhookSecurity.allowedHosts ke nama host publik, atau gunakan webhookSecurity.trustedProxyIPs untuk alamat proksi yang dikenal. Gunakan webhookSecurity.trustForwardingHeaders hanya saat batas proksi berada di bawah kendali Anda.

Verifikasi tanda tangan gagal

Tanda tangan penyedia diperiksa terhadap URL publik yang direkonstruksi OpenClaw dari permintaan masuk. Jika tanda tangan gagal:

• Pastikan URL Webhook penyedia sama persis dengan publicUrl, termasuk skema, host, dan jalur.
• Untuk URL tingkat gratis ngrok, perbarui publicUrl saat nama host tunnel berubah.
• Pastikan proksi mempertahankan header host dan proto asli, atau konfigurasikan webhookSecurity.allowedHosts.
• Jangan aktifkan skipSignatureVerification di luar pengujian lokal.

Kegagalan bergabung ke Google Meet melalui Twilio

Google Meet menggunakan Plugin ini untuk bergabung melalui sambungan telepon Twilio. Pertama, verifikasi Voice Call:

openclaw voicecall setupopenclaw voicecall smoke --to "+15555550123"

Kemudian verifikasi transport Google Meet secara eksplisit:

openclaw googlemeet setup --transport twilio

Jika Voice Call berstatus hijau, tetapi peserta Meet tidak pernah bergabung, periksa nomor sambungan telepon Meet, PIN, dan --dtmf-sequence. Panggilan telepon dapat berfungsi dengan baik sementara rapat menolak atau mengabaikan urutan DTMF yang salah.

Google Meet memulai bagian panggilan telepon Twilio melalui voicecall.start dengan urutan DTMF sebelum tersambung. Urutan yang berasal dari PIN menyertakan voiceCall.dtmfDelayMs milik Plugin Google Meet (default 12000 ms) sebagai digit tunggu Twilio di awal, karena prompt sambungan telepon Meet dapat terlambat tiba. Voice Call kemudian mengalihkan kembali ke penanganan waktu nyata sebelum salam pembuka diminta.

Gunakan openclaw logs --follow untuk pelacakan fase langsung. Proses bergabung ke Meet melalui Twilio yang berfungsi dengan baik mencatat urutan ini:

• Google Meet mendelegasikan proses bergabung melalui Twilio kepada Voice Call.
• Voice Call menyimpan TwiML DTMF sebelum tersambung.
• TwiML awal Twilio digunakan dan disajikan sebelum penanganan waktu nyata.
• Voice Call menyajikan TwiML waktu nyata untuk panggilan Twilio.
• Google Meet meminta ucapan pembuka dengan voicecall.speak setelah penundaan pasca-DTMF.

openclaw voicecall tail tetap menampilkan rekaman panggilan yang dipertahankan; berguna untuk status dan transkrip panggilan, tetapi tidak setiap transisi Webhook/waktu nyata ditampilkan di sana.

Panggilan waktu nyata tidak mengeluarkan suara

Pastikan hanya satu mode audio yang diaktifkan: realtime.enabled dan streaming.enabled tidak boleh sama-sama bernilai true.

Untuk panggilan Twilio/Telnyx waktu nyata, verifikasi juga:

• Plugin penyedia waktu nyata dimuat dan didaftarkan.
• realtime.provider tidak ditetapkan atau menyebutkan penyedia yang terdaftar.
• Kunci API penyedia tersedia bagi proses Gateway.
• openclaw logs --follow menampilkan TwiML waktu nyata disajikan, jembatan waktu nyata dimulai, dan salam awal dimasukkan ke antrean.

Terkait

• Mode bicara
• Teks ke ucapan
• Aktivasi suara