Hoppa till huvudinnehåll

​
Röstsamtal (plugin)

Röstsamtal för OpenClaw via en plugin. Stöder utgående meddelanden och multi-turn konversationer med inkommande policyer. Nuvarande leverantörer:
  • twilio (Programmerbar röst + medieströmmar)
  • telnyx (Samtalskontroll v2)
  • plivo (Voice API + XML-överföring + GetInput-tal)
  • mock (dev/ingen nätverksåtkomst)
Snabb mental modell:
  • Installera plugin
  • Starta om Gateway
  • Konfigurera under plugins.entries.voice-call.config
  • Använd openclaw voicecall ... eller verktyget voice_call

​
Var den körs (lokalt vs fjärr)

Röstsamtalspluginet körs inuti Gateway-processen. Om du använder en fjärr-Gateway, installera/konfigurera pluginet på maskinen som kör Gateway, och starta sedan om Gateway för att läsa in det.

​
Installera

​
Alternativ A: installera från npm (rekommenderas)

openclaw plugins install @openclaw/voice-call
Starta om Gateway efteråt.

​
Alternativ B: installera från en lokal mapp (dev, ingen kopiering)

openclaw plugins install ./extensions/voice-call
cd ./extensions/voice-call && pnpm install
Starta om Gateway efteråt.

​
Konfiguration

Ställ in konfiguration under plugins.entries.voice-call.config: 
{
  plugins: {
    entries: {
      "voice-call": {
        enabled: true,
        config: {
          provider: "twilio", // or "telnyx" | "plivo" | "mock"
          fromNumber: "+15550001234",
          toNumber: "+15550005678",

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

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

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

          // Webhook security (recommended for tunnels/proxies)
          webhookSecurity: {
            allowedHosts: ["voice.example.com"],
            trustedProxyIPs: ["100.64.0.1"],
          },

          // Public exposure (pick one)
          // publicUrl: "https://example.ngrok.app/voice/webhook",
          // tunnel: { provider: "ngrok" },
          // tailscale: { mode: "funnel", path: "/voice/webhook" }

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

          streaming: {
            enabled: true,
            streamPath: "/voice/stream",
          },
        },
      },
    },
  },
}
Noteringar:
  • Twilio/Telnyx kräver en offentligt nåbar webhook-URL.
  • Plivo kräver en offentligt nåbar webhook-URL.
  • mock är en lokal dev‑leverantör (inga nätverksanrop).
  • skipSignatureVerification är endast för lokal testning.
  • Om du använder ngrok free tier, sätt publicUrl till den exakta ngrok‑URL:en; signaturverifiering tillämpas alltid.
  • Om du använder ngrok free tier, sätt publicUrl till den exakta ngrok‑URL:en; signaturverifiering tillämpas alltid.
  • tunnel.allowNgrokFreeTierLoopbackBypass: true tillåter Twilio webhooks med ogiltiga signaturer bara när tunnel.provider="ngrok" och serve.bind är loopback (ngrok lokal agent). Använd endast för lokal utvecklare.
  • Ngrok free tier URLs kan ändra eller lägga till interstitiellt beteende; om publicUrl drifts, kommer Twilio signaturer misslyckas. För produktion, föredrar en stabil domän eller Tailscale tratt.

​
Webhook-säkerhet

När en proxy eller tunnel sitter framför Gateway, rekonstruerar pluginen den publika -URL:en för signaturverifiering. Dessa alternativ kontrollerar vilka vidarebefordrade rubriker är betrodda. webhookSecurity.allowedHosts tillåter värdar från vidarebefordrade headers via tillåtelselista. webhookSecurity.trustForwardingHeaders litar på vidarebefordrade headers utan tillåtelselista. webhookSecurity.trustedProxyIPs litar endast på vidarebefordrade headers när begärans fjärr-IP matchar listan. Exempel med en stabil publik värd: 
{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          publicUrl: "https://voice.example.com/voice/webhook",
          webhookSecurity: {
            allowedHosts: ["voice.example.com"],
          },
        },
      },
    },
  },
}

​
TTS för samtal

Röstsamtal använder kärnkonfigurationen messages.tts (OpenAI eller ElevenLabs) för strömmande tal på samtal. Du kan åsidosätta det under plugin-konfigurationen med samma form - det djup-merges med messages.tts. 
{
  tts: {
    provider: "elevenlabs",
    elevenlabs: {
      voiceId: "pMsXgVXv3BLzUgSXRplE",
      modelId: "eleven_multilingual_v2",
    },
  },
}
Noteringar:
  • Edge TTS ignoreras för röstsamtal (telefoni‑ljud kräver PCM; Edge‑utdata är opålitligt).
  • Kärn‑TTS används när Twilio media streaming är aktiverat; annars faller samtal tillbaka till leverantörens inbyggda röster.

​
Fler exempel

Använd endast kärn‑TTS (ingen åsidosättning): 
{
  messages: {
    tts: {
      provider: "openai",
      openai: { voice: "alloy" },
    },
  },
}
Åsidosätt till ElevenLabs endast för samtal (behåll kärnstandard i övrigt): 
{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          tts: {
            provider: "elevenlabs",
            elevenlabs: {
              apiKey: "elevenlabs_key",
              voiceId: "pMsXgVXv3BLzUgSXRplE",
              modelId: "eleven_multilingual_v2",
            },
          },
        },
      },
    },
  },
}
Åsidosätt endast OpenAI‑modellen för samtal (exempel på djup‑sammanfogning): 
{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          tts: {
            openai: {
              model: "gpt-4o-mini-tts",
              voice: "marin",
            },
          },
        },
      },
    },
  },
}

​
Inkommande samtal

Inkommande policy-standard är inaktiverad. Ange för att aktivera inkommande samtal: 
{
  inboundPolicy: "allowlist",
  allowFrom: ["+15550001234"],
  inboundGreeting: "Hello! How can I help?",
}
Auto-svar använder agentsystemet. Justera med:
  • responseModel
  • responseSystemPrompt
  • responseTimeoutMs

​
CLI

openclaw voicecall call --to "+15555550123" --message "Hello from OpenClaw"
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 expose --mode funnel

​
Agentverktyg

Verktygsnamn: voice_call Åtgärder:
  • initiate_call (message, to?, mode?)
  • continue_call (callId, message)
  • speak_to_user (callId, message)
  • end_call (callId)
  • get_status (callId)
Detta repo levererar ett matchande Skills‑dokument på skills/voice-call/SKILL.md.

​
Gateway-RPC

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