OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Plugin guides

Voice call plugin

Voice calls for OpenClaw via a plugin: outbound notifications, multi-turn conversations, full-duplex realtime voice, streaming transcription, and inbound calls with allowlist policies.

Providers: mock (dev, no network), plivo (Voice API + XML transfer + GetInput speech), telnyx (Call Control v2), twilio (Programmable Voice + Media Streams).

Quick start

  • Install the plugin

    From npm

    bash
    openclaw plugins install @openclaw/voice-call

    From a local folder (dev)

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

    Use the bare package to follow the current release tag. Pin an exact version only when you need a reproducible install. Restart the Gateway afterwards so the plugin loads.

  • Configure provider and webhook

    Set config under plugins.entries.voice-call.config (see Configuration). At minimum: provider, provider credentials, fromNumber, and a publicly reachable webhook URL. With multiple agents, also set agentId to the agent that should own calls.

    For an inbound Twilio number, set its Voice webhook to the public Voice Call webhook URL with method POST. Set the number-level Status Callback to the same URL with ?type=status, also using POST, so terminal inbound call statuses reach the plugin.

  • Verify setup

    bash
    openclaw voicecall setupopenclaw voicecall setup --json

    Checks plugin enablement, provider credentials, webhook exposure, agent ownership, and that only one audio mode (streaming or realtime) is active.

  • Smoke test

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

    Both are dry runs by default. Add --yes to place a short outbound notify call:

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

    • Where each section moved

    Every section of the single-page version now lives on this page or on one of the five child pages below. The anchors from the single-page version still resolve here.

    Voice call configuration

    Voice call configuration — plugin config keys, the call owner, the full config reference table, and session scope.

    Voice call realtime and streaming

    Voice call realtime and streaming — full-duplex realtime voice, hangup detection, tool and consult policy, agent voice context, and Twilio Media Streams transcription.

    Voice call TTS and inbound calls

    Voice call TTS and inbound calls — telephony text-to-speech, inbound policy and per-number routing, the spoken output contract, conversation startup, and the stale call reaper.

    Voice call security and interfaces

    Voice call security and interfaces — webhook signature and forwarding-header security, plus the CLI, agent tool, and Gateway RPC surfaces.

    Voice call troubleshooting

    Voice call troubleshooting — fixes for setup, webhook exposure, credentials, signature verification, Google Meet dial-in, and silent realtime calls.

    Was this useful?
    On this page

    On this page