> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Röstsamtalsplugin

# 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)

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/voice-call
```

Starta om Gateway efteråt.

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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`:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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`.

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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):

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  messages: {
    tts: {
      provider: "openai",
      openai: { voice: "alloy" },
    },
  },
}
```

Åsidosätt till ElevenLabs endast för samtal (behåll kärnstandard i övrigt):

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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):

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  inboundPolicy: "allowlist",
  allowFrom: ["+15550001234"],
  inboundGreeting: "Hello! How can I help?",
}
```

Auto-svar använder agentsystemet. Justera med:

* `responseModel`
* `responseSystemPrompt`
* `responseTimeoutMs`

## CLI

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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`)