​

Voice Call (plugin)

• twilio (Programmable Voice + Media Streams)
• telnyx (Call Control v2)
• plivo (Voice API + XML aktarımı + GetInput konuşma)
• mock (geliştirme/ağ yok)

• Plugin’i kurun
• Gateway’i yeniden başlatın
• plugins.entries.voice-call.config altında yapılandırın
• openclaw voicecall ... veya voice_call aracını kullanın

​

Çalıştığı yer (yerel ve uzak)

​

Kurulum

​

Seçenek A: npm’den kurulum (önerilir)

openclaw plugins install @openclaw/voice-call

​

Seçenek B: yerel klasörden kurulum (geliştirme, kopyalama yok)

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

​

Yapılandırma

{
  plugins: {
    entries: {
      "voice-call": {
        enabled: true,
        config: {
          provider: "twilio", // veya "telnyx" | "plivo" | "mock"
          fromNumber: "+15550001234",
          toNumber: "+15550005678",

          twilio: {
            accountSid: "ACxxxxxxxx",
            authToken: "...",
          },

          telnyx: {
            apiKey: "...",
            connectionId: "...",
            // Telnyx Mission Control Portal'dan Telnyx webhook açık anahtarı
            // (Base64 dizesi; TELNYX_PUBLIC_KEY üzerinden de ayarlanabilir).
            publicKey: "...",
          },

          plivo: {
            authId: "MAxxxxxxxxxxxxxxxxxxxx",
            authToken: "...",
          },

          // Webhook sunucusu
          serve: {
            port: 3334,
            path: "/voice/webhook",
          },

          // Webhook güvenliği (tüneller/proxy'ler için önerilir)
          webhookSecurity: {
            allowedHosts: ["voice.example.com"],
            trustedProxyIPs: ["100.64.0.1"],
          },

          // Genel erişim (birini seçin)
          // publicUrl: "https://example.ngrok.app/voice/webhook",
          // tunnel: { provider: "ngrok" },
          // tailscale: { mode: "funnel", path: "/voice/webhook" }

          outbound: {
            defaultMode: "notify", // notify | conversation
          },

          streaming: {
            enabled: true,
            provider: "openai", // isteğe bağlı; ayarlanmazsa ilk kayıtlı gerçek zamanlı transkripsiyon sağlayıcısı
            streamPath: "/voice/stream",
            providers: {
              openai: {
                apiKey: "sk-...", // OPENAI_API_KEY ayarlıysa isteğe bağlı
                model: "gpt-4o-transcribe",
                silenceDurationMs: 800,
                vadThreshold: 0.5,
              },
            },
            preStartTimeoutMs: 5000,
            maxPendingConnections: 32,
            maxPendingConnectionsPerIp: 4,
            maxConnections: 128,
          },
        },
      },
    },
  },
}

• Twilio/Telnyx, genel olarak erişilebilir bir webhook URL’si gerektirir.
• Plivo, genel olarak erişilebilir bir webhook URL’si gerektirir.
• mock, yerel bir geliştirme sağlayıcısıdır (ağ çağrısı yok).
• Eski yapılandırmalar hâlâ provider: "log", twilio.from veya eski streaming.* OpenAI anahtarlarını kullanıyorsa, bunları yeniden yazmak için openclaw doctor --fix çalıştırın.
• skipSignatureVerification true değilse Telnyx, telnyx.publicKey (veya TELNYX_PUBLIC_KEY) gerektirir.
• skipSignatureVerification yalnızca yerel test içindir.
• ngrok ücretsiz katmanını kullanıyorsanız, publicUrl değerini tam ngrok URL’si olarak ayarlayın; imza doğrulaması her zaman zorunludur.
• tunnel.allowNgrokFreeTierLoopbackBypass: true, yalnızca tunnel.provider="ngrok" ve serve.bind loopback olduğunda (ngrok yerel ajanı) geçersiz imzalara sahip Twilio webhook’larına izin verir. Yalnızca yerel geliştirme için kullanın.
• Ngrok ücretsiz katman URL’leri değişebilir veya araya giren davranış ekleyebilir; publicUrl kayarsa Twilio imzaları başarısız olur. Üretim için kararlı bir etki alanı veya Tailscale funnel tercih edin.
• Akış güvenliği varsayılanları:
  • streaming.preStartTimeoutMs, hiçbir zaman geçerli bir start çerçevesi göndermeyen soketleri kapatır.
• streaming.maxPendingConnections, kimliği doğrulanmamış başlatma öncesi toplam soket sayısını sınırlar.
• streaming.maxPendingConnectionsPerIp, kaynak IP başına kimliği doğrulanmamış başlatma öncesi soket sayısını sınırlar.
• streaming.maxConnections, toplam açık medya akışı soketlerini sınırlar (bekleyen + etkin).
• Çalışma zamanı yedeği şimdilik bu eski voice-call anahtarlarını kabul etmeye devam eder, ancak yeniden yazma yolu openclaw doctor --fix komutudur ve uyumluluk katmanı geçicidir.

​

Akış transkripsiyonu

• streaming.provider isteğe bağlıdır. Ayarlanmazsa Voice Call ilk kayıtlı gerçek zamanlı transkripsiyon sağlayıcısını kullanır.
• Bugün paketlenmiş sağlayıcı, paketlenmiş openai plugin’i tarafından kaydedilen OpenAI’dir.
• Sağlayıcıya ait ham yapılandırma streaming.providers.<providerId> altında bulunur.
• streaming.provider, kayıtlı olmayan bir sağlayıcıyı işaret ediyorsa veya hiç gerçek zamanlı transkripsiyon sağlayıcısı kayıtlı değilse, Voice Call bir uyarı günlüğe kaydeder ve tüm plugin’i başarısız kılmak yerine medya akışını atlar.

• API anahtarı: streaming.providers.openai.apiKey veya OPENAI_API_KEY
• model: gpt-4o-transcribe
• silenceDurationMs: 800
• vadThreshold: 0.5

{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "openai",
            streamPath: "/voice/stream",
            providers: {
              openai: {
                apiKey: "sk-...", // OPENAI_API_KEY ayarlıysa isteğe bağlı
                model: "gpt-4o-transcribe",
                silenceDurationMs: 800,
                vadThreshold: 0.5,
              },
            },
          },
        },
      },
    },
  },
}

• streaming.sttProvider → streaming.provider
• streaming.openaiApiKey → streaming.providers.openai.apiKey
• streaming.sttModel → streaming.providers.openai.model
• streaming.silenceDurationMs → streaming.providers.openai.silenceDurationMs
• streaming.vadThreshold → streaming.providers.openai.vadThreshold

​

Eski çağrı temizleyicisi

• Üretim: notify tarzı akışlar için 120–300 saniye.
• Normal çağrıların bitebilmesi için bu değeri maxDurationSeconds değerinden büyük tutun. İyi bir başlangıç noktası maxDurationSeconds + 30–60 saniyedir.

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

​

Webhook Güvenliği

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

​

Aramalar için TTS

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

• Plugin yapılandırması içindeki eski tts.<provider> anahtarları (openai, elevenlabs, microsoft, edge) yükleme sırasında otomatik olarak tts.providers.<provider> biçimine taşınır. Kaydedilmiş yapılandırmada providers biçimini tercih edin.
• Microsoft speech, sesli aramalar için yok sayılır (telefon sesinin PCM olması gerekir; mevcut Microsoft taşıması telefon PCM çıkışını açığa çıkarmaz).
• Twilio medya akışı etkin olduğunda çekirdek TTS kullanılır; aksi halde aramalar sağlayıcının yerel seslerine geri döner.
• Bir Twilio medya akışı zaten etkinse Voice Call, TwiML <Say> kullanımına geri dönmez. Telefon TTS bu durumda kullanılamıyorsa, iki oynatma yolunu karıştırmak yerine oynatma isteği başarısız olur.
• Telefon TTS ikinci bir sağlayıcıya geri düştüğünde Voice Call, hata ayıklama için sağlayıcı zinciriyle (from, to, attempts) bir uyarı günlüğe kaydeder.

​

Daha fazla örnek

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

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

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

​

Gelen aramalar

{
  inboundPolicy: "allowlist",
  allowFrom: ["+15550001234"],
  inboundGreeting: "Merhaba! Nasıl yardımcı olabilirim?",
}

• responseModel
• responseSystemPrompt
• responseTimeoutMs

​

Sesli çıktı sözleşmesi

• {"spoken":"..."}

• Akıl yürütme/hata içeriği olarak işaretlenmiş yükleri yok sayar.
• Doğrudan JSON, çitlenmiş JSON veya satır içi "spoken" anahtarlarını ayrıştırır.
• Düz metne geri döner ve olası planlama/meta giriş paragraflarını kaldırır.

​

Konuşma başlangıç davranışı

• Araya girme kuyruğu temizleme ve otomatik yanıt, yalnızca ilk selamlama etkin olarak konuşulurken bastırılır.
• İlk oynatma başarısız olursa çağrı listening durumuna döner ve ilk mesaj yeniden deneme için kuyrukta kalır.
• Twilio akışı için ilk oynatma, ek gecikme olmadan akış bağlandığında başlar.

​

Twilio akış bağlantı kesilmesi toleransı

• Akış bu pencere sırasında yeniden bağlanırsa otomatik sonlandırma iptal edilir.
• Tolerans süresinden sonra hiçbir akış yeniden kaydedilmezse, takılı kalmış etkin çağrıları önlemek için çağrı sonlandırılır.

​

CLI

openclaw voicecall call --to "+15555550123" --message "Hello from OpenClaw"
openclaw voicecall start --to "+15555550123"   # call için takma ad
openclaw voicecall continue --call-id <id> --message "Any questions?"
openclaw voicecall speak --call-id <id> --message "One moment"
openclaw voicecall end --call-id <id>
openclaw voicecall status --call-id <id>
openclaw voicecall tail
openclaw voicecall latency                     # günlüklerden tur gecikmesini özetler
openclaw voicecall expose --mode funnel

​

Ajan aracı

• initiate_call (message, to?, mode?)
• continue_call (callId, message)
• speak_to_user (callId, message)
• end_call (callId)
• get_status (callId)

​

Gateway RPC

• voicecall.initiate (to?, message, mode?)
• voicecall.continue (callId, message)
• voicecall.speak (callId, message)
• voicecall.end (callId)
• voicecall.status (callId)