home / skills / openclaw / openclaw / voice-call

voice-call skill

safe

This skill helps you start and manage voice calls across Twilio, Telnyx, Plivo, or mock, enabling seamless AI assisted communication.

npx playbooks add skill openclaw/openclaw --skill voice-call

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

1.1 KB

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

```bash
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).

Overview

This skill lets your AI assistant start and manage voice calls via the OpenClaw voice-call plugin. It supports Twilio, Telnyx, Plivo, or a mock provider for local development. Use it to initiate calls, speak during an active call, check status, and end calls programmatically.

How this skill works

The skill exposes a voice_call tool with actions like initiate_call, continue_call, speak_to_user, end_call, and get_status. Calls are routed through the provider configured under plugins.entries.voice-call.config; the plugin translates agent requests into provider API calls. A mock provider is available for testing without network access.

When to use it

Place outbound voice calls from an AI agent to users or systems.
Deliver short voice notifications or confirmations programmatically.
Run interactive voice sessions where the agent speaks multiple times.
Check call status or terminate calls started by the agent.
Develop and test voice call flows locally using the mock provider.

Best practices

Ensure the voice-call plugin is enabled and properly configured in plugins.entries.voice-call.config before using the tool.
Store provider credentials (Twilio/Telnyx/Plivo) securely and avoid hardcoding secrets in code.
Use concise messages for initial call prompts to minimize call length and cost.
Use get_status to verify call state before calling continue_call or end_call to avoid errors.
Use the mock provider during development to iterate without network calls or billing.

Example use cases

Initiate a verification call that speaks a one-time code to a user number.
Automate appointment reminders by calling clients and delivering a prerecorded message.
Run a short interactive support call where the agent provides several prompts during the session.
Monitor and report call status to internal dashboards or logs.
End stuck or long-running calls programmatically if a timeout or error condition occurs.

FAQ

What provider configs are required?

Configure provider under plugins.entries.voice-call.config. Twilio needs provider: "twilio" plus twilio.accountSid, twilio.authToken, and fromNumber. Telnyx and Plivo require their respective API keys/ids and fromNumber.

Can I test without real telephony?

Yes. Use provider: "mock" to run calls locally without network requests or billing.