amber-voice-assistant

What This Skill Does

Amber is a high-performance voice and phone automation engine for the OpenClaw ecosystem. It functions as a sophisticated bridge between Twilio’s telecommunications infrastructure and OpenAI’s Realtime speech capabilities. By integrating a local SQLite-backed CRM, Amber allows your OpenClaw agent to hold natural, context-aware telephone conversations. It recognizes repeat callers, manages appointment scheduling through integrated calendar tools, and supports live message logging.

Beyond basic telephony, Amber introduces a modular "Skill" architecture, allowing developers to extend voice conversations with custom capabilities. The agent can perform complex tasks mid-call, such as updating customer records, checking availability, or escalating to human operators when specific triggers are met. As of v5.4.0, it includes a Claude Desktop MCP plugin, enabling users to orchestrate outbound calls and manage CRM data directly through the Claude interface.

Installation

To get started, ensure you have your Twilio and OpenAI credentials prepared. Open your terminal in the OpenClaw environment and run:

clawhub install openclaw/skills/skills/batthis/amber-voice-assistant

Once the repository is downloaded, execute the setup wizard by running npm run setup. This interactive utility will conduct preflight checks, verify your API credentials, detect your networking setup (such as ngrok tunnels), and automatically generate a secure .env file, ensuring the runtime bridge is correctly configured for your specific deployment.

Use Cases

1. Automated Receptionist: Manage inbound business calls, screen callers, and route important messages to team members based on priority.
2. Outbound Appointment Booking: Proactively reach out to contacts in the CRM to confirm meetings or follow up on project statuses, with automatic calendar synchronization.
3. Voice-to-CRM Logging: Automatically transcribe and log every conversation detail into your local SQLite CRM, ensuring no client context is lost across multiple interactions.
4. Claude-Driven Telephony: Use the Claude Desktop MCP to trigger outbound calls to specific contacts by name, allowing for voice-controlled administrative workflows.

Example Prompts

• "Amber, please call the primary contact from the latest support ticket and ask if they are available for a follow-up meeting tomorrow afternoon."
• "Check my calendar for tomorrow and update the CRM contact for 'Sarah Miller' to note that she confirmed the rescheduled appointment time."
• "What does my call history look like for the last 24 hours? Are there any urgent messages from potential clients?"

Tips & Limitations

To ensure consistent performance, verify that your Twilio phone number is correctly mapped to your public-facing URL provided by your tunnel provider. Because this skill relies on OpenAI Realtime voice capabilities, ensure your account has sufficient quota for high-latency, bidirectional audio streaming. While the built-in safety guardrails help prevent erroneous dialing, always review logs in the provided dashboard when testing complex outbound workflows. The local SQLite CRM is highly efficient but should be backed up regularly if your contact list scales significantly.