Voice Call — OpenClaw Skill

What This Skill Does

The Voice Call skill enables your OpenClaw AI agent to initiate, manage, and monitor phone calls through the voice-call plugin. It supports three major telephony providers -- Twilio, Telnyx, and Plivo -- giving your agent the ability to place outbound calls, deliver spoken messages, continue multi-turn voice conversations, and check the status of active calls.

When you tell your agent to "call the restaurant and confirm our reservation," it uses the configured telephony provider to place the call, deliver your message via text-to-speech, and report back on the call status. The skill supports the full call lifecycle: initiating, continuing with follow-up messages, speaking to the user during an active call, and ending the call gracefully.

A mock provider mode is included for development and testing, allowing you to verify the entire call flow without connecting to a real telephony network or incurring per-minute charges. This makes it safe to iterate on voice workflows before going live.

Example Prompts

"Call +1-555-123-4567 and tell them our meeting is rescheduled to 3pm"

"Check the status of my last outgoing call"

"End the current call"

"Call my dentist's office and ask if they have availability next Tuesday"

"Send a voice message to +44-20-7946-0958 saying the shipment has been dispatched"

"Continue the call and ask them about their return policy"

Requirements

• Voice-call plugin enabled in OpenClaw configuration
• A telephony provider account: Twilio, Telnyx, or Plivo
• Provider API credentials (account SID, auth token, or API key)
• A registered from number for outbound calls

On KiwiClaw: Pre-installed. Add your telephony provider credentials in the dashboard and the skill is ready.

Self-hosted: Enable the voice-call plugin in your OpenClaw config at plugins.entries.voice-call.enabled: true. Configure your provider under plugins.entries.voice-call.config.

Setup on KiwiClaw

1. Open your KiwiClaw dashboard
2. Navigate to Skills in your agent settings
3. Enable the Voice Call skill
4. Enter your Twilio, Telnyx, or Plivo credentials and from number
5. Test with a call to verify the connection

Setup Self-Hosted

1. Enable the plugin in ~/.openclaw/openclaw.json: set plugins.entries.voice-call.enabled to true
2. Configure your provider -- for example, Twilio: set provider: "twilio", twilio.accountSid, twilio.authToken, and fromNumber
3. For testing, use provider: "mock" to simulate calls without network
4. Test: openclaw voicecall call --to "+15555550123" --message "Test call"
5. Check status: openclaw voicecall status --call-id <id>

Related Skills

• Slack -- communicate with your team via text channels
• Discord -- connect to Discord for voice and text
• Summarize -- transcribe and summarize call recordings
• Apple Reminders -- schedule follow-up reminders after calls

FAQ

Which telephony providers does the Voice Call skill support?

The skill supports three providers: Twilio, Telnyx, and Plivo. Each requires its own API credentials and a registered phone number. You can also use a mock provider for development and testing without making real calls.

Can the AI agent have a two-way phone conversation?

Yes. The voice-call plugin supports initiating calls, continuing ongoing calls with additional messages, and speaking directly to the user during a call. The agent can maintain a multi-turn voice conversation through the continue_call and speak_to_user actions.

Does the Voice Call skill cost extra beyond the KiwiClaw subscription?

The skill itself is free and pre-installed on KiwiClaw. However, actual phone calls are billed by your telephony provider (Twilio, Telnyx, or Plivo) at their standard per-minute rates. You bring your own provider account and API keys.

Can I test the voice call skill without making real phone calls?

Yes. The skill includes a mock provider mode that simulates calls without connecting to any telephony network. Set the provider to "mock" in your configuration to test the full call flow locally.