voice-call

What This Skill Does

The Voice Call skill empowers your OpenClaw agent to initiate and manage voice calls using various telephony providers like Twilio, Telnyx, and Plivo, or a development-friendly mock provider. This skill allows for programmatic control over outbound calls, enabling agents to connect with users, deliver messages, and even monitor call statuses. It's an essential tool for automating communication workflows that require direct voice interaction.

Installation

To integrate the Voice Call skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/openclaw/skills/voice-call

This command will download and install the necessary components for the voice-call plugin. Remember to enable the plugin within your OpenClaw configuration. The plugin configuration details can be found under plugins.entries.voice-call.config. You will need to select a provider (twilio, telnyx, plivo, or mock) and configure it with the appropriate credentials and parameters, such as API keys, account SIDs, auth tokens, connection IDs, and your designated fromNumber.

Use Cases

The Voice Call skill unlocks a variety of automated communication scenarios:

• Customer Support: Automate follow-up calls to customers who have submitted support tickets, providing updates or requesting further information.
• Appointment Reminders: Schedule automated calls to remind users of upcoming appointments, reducing no-shows.
• Notification Systems: Implement a system for urgent alerts or notifications that require immediate attention via voice.
• Outbound Marketing: Conduct simple outbound calls for surveys, feedback collection, or promotional messages (ensure compliance with regulations).
• Interactive Voice Response (IVR) Integration: Build basic IVR flows by initiating calls and providing spoken prompts.
• Development & Testing: Utilize the mock provider for testing call initiation logic without incurring actual telephony costs or network dependencies.

Example Prompts

Here are three example prompts a user might send to an OpenClaw agent equipped with the Voice Call skill:

1. "Call John Doe at +15555550123 and tell him his order has shipped."
2. "Check the status of the call with ID abc123xyz."
3. "Initiate a call to the support line at +15555550124, and say 'Please hold while we connect you.'"

Tips & Limitations

• Provider Configuration: Ensure your chosen telephony provider is correctly configured in plugins.entries.voice-call.config with valid credentials and a fromNumber that is authorized for making calls.
• Error Handling: Implement robust error handling in your agent's logic to manage potential issues with call initiation, network connectivity, or provider errors.
• Call ID Management: When using continue_call, speak_to_user, end_call, or get_status, you will need to manage and provide the callId returned from initiate_call.
• Message Length: Be mindful of the length of messages sent via voice, as excessively long messages might be cut off or impact user experience.
• Regulatory Compliance: Ensure all outbound calling activities comply with relevant telecommunications regulations (e.g., TCPA in the US).
• Mock Provider: The mock provider is excellent for development and testing but does not simulate real-world network latency or carrier behavior.
• Cost: Be aware of the potential costs associated with using commercial telephony providers like Twilio, Telnyx, or Plivo.