voice-call

steipete/clawdis

Start and manage voice calls via Twilio, Telnyx, Plivo, or mock provider.

What is voice-call?

The voice-call skill enables agents to initiate, continue, and manage voice calls through the OpenClaw voice-call plugin. Use it when you need to programmatically make outbound calls, speak to users, check call status, or end active calls.

Initiate outbound voice calls with custom messages
Continue conversations within an active call
Speak messages to users during a call
End active calls
Check call status and retrieve call information

How to install voice-call

npx skills add https://github.com/steipete/clawdis --skill voice-call

Prerequisites

voice-call plugin enabled in OpenClaw config
Provider credentials (Twilio accountSid/authToken, Telnyx apiKey/connectionId, or Plivo authId/authToken)
fromNumber configured for your chosen provider

Claude Code

Cursor

Windsurf

Cline

How to use voice-call

1.Enable the voice-call plugin in your OpenClaw configuration
2.Configure your provider (Twilio, Telnyx, Plivo, or mock) with required credentials and fromNumber
3.Use the voice_call tool with initiate_call action to start a call with a message and destination number
4.Use continue_call or speak_to_user to send messages during an active call
5.Use get_status to check call progress or end_call to terminate the call

Use cases

Good for

Automated customer support calls with message delivery
Agent-initiated outbound calling workflows
Real-time call status monitoring and management
Testing voice call functionality with mock provider
Multi-provider call routing (Twilio, Telnyx, Plivo)

Who it's for

Customer support agents
Outbound calling automation developers
Voice-enabled chatbot builders
Call center integration engineers

voice-call FAQ

Which voice providers are supported?

Twilio, Telnyx, Plivo, and a mock provider for development/testing without network calls.

How do I configure the voice-call plugin?

Set plugin config under plugins.entries.voice-call.config with your chosen provider, credentials (accountSid/authToken, apiKey/connectionId, or authId/authToken), and fromNumber.

Can I use this for inbound calls?

The skill is designed for agent-initiated outbound calls. Inbound call handling would require additional plugin configuration.

What's the difference between speak_to_user and continue_call?

Both send messages during a call; speak_to_user is for agent-to-user messages, while continue_call is for continuing a conversation flow.

Is there a way to test without a real provider?

Yes, set provider to 'mock' in your config for development and testing without network calls.

Full instructions (SKILL.md)

Source of truth, from steipete/clawdis.

name: voice-call description: "Start voice calls via the OpenClaw voice-call plugin." metadata: { "openclaw": { "emoji": "📞", "skillKey": "voice-call", "requires": { "config": ["plugins.entries.voice-call.enabled"] }, }, }

Voice Call

Use the voice-call plugin to start or inspect calls (Twilio, Telnyx, Plivo, or mock).

CLI

openclaw voicecall call --to "+15555550123" --message "Hello from OpenClaw"
openclaw voicecall status --call-id <id>

Tool

Use voice_call for agent-initiated calls.

Actions:

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

Notes:

Requires the voice-call plugin to be enabled.
Plugin config lives under plugins.entries.voice-call.config.
Twilio config: provider: "twilio" + twilio.accountSid/authToken + fromNumber.
Telnyx config: provider: "telnyx" + telnyx.apiKey/connectionId + fromNumber.
Plivo config: provider: "plivo" + plivo.authId/authToken + fromNumber.
Dev fallback: provider: "mock" (no network).