openclaw-phone-receipt
Trigger and manage OpenClaw outbound phone receipts via ElevenLabs+Twilio for task completion/failure notifications. Use when user asks to call them after finishing/failing a task, asks to enable/disable fixed command toggles ("phone-receipt=on/off"), asks to test call quality, or asks to persist phone receipt behavior across sessions.
Why use this skill?
Integrate ElevenLabs and Twilio with OpenClaw to receive automated voice alerts for task failures and urgent notifications. Easy setup and configuration.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/tuofangzhe/openclaw-phone-receiptWhat This Skill Does
The openclaw-phone-receipt skill enables your OpenClaw agent to communicate task outcomes via voice calls using the ElevenLabs and Twilio integration. This skill provides an automated notification bridge between your agent's task completion state and your phone, ensuring you are immediately alerted when critical work is finished or when failures occur. By maintaining a persistent state in memory/phone-receipt-state.json, the agent remembers your notification preferences across sessions.
Installation
To install this skill, run the following command in your terminal:
clawhub install openclaw/skills/skills/tuofangzhe/openclaw-phone-receipt
Ensure that you have configured your environment variables in .env.elevenlabs-call, including ELEVENLABS_AGENT_ID, ELEVENLABS_OUTBOUND_PHONE_ID, and your TO_NUMBER. The system requires an active ElevenLabs API key and a verified Twilio number to function. For detailed setup procedures, including Twilio verification and ElevenLabs integration, refer to references/setup.md.
Use Cases
This skill is ideal for users who perform time-sensitive or background tasks that require immediate attention upon failure or high-priority completion. Use this when:
- You are running long-running tasks and need to be alerted if they fail.
- You designate specific tasks as "urgent" or "high-priority," requiring a voice notification regardless of success.
- You want to toggle voice notifications on or off dynamically without reconfiguring your entire agent workflow.
- You wish to test your connection to the ElevenLabs/Twilio gateway to ensure call quality and delivery settings are configured correctly.
Example Prompts
- "Enable phone notifications for all my future tasks, I need to know immediately if something goes wrong."
- "phone-receipt=off, I'm in a meeting right now and don't want to receive any voice calls."
- "Test my phone receipt connection now, please trigger a call to verify the ElevenLabs voice quality."
Tips & Limitations
- Delivery Strategy: To reduce noise, the skill defaults to sending Telegram text summaries for non-urgent successful tasks. Only task failures or user-marked urgent tasks will trigger a voice call.
- Failure Handling: If a call fails, check your Twilio logs for unverified number issues or your environment file for missing scope permissions like
convai_read. - Persistence: All state changes are written to the local memory folder. Ensure the agent has appropriate file-write permissions to persist your preferences between restarts.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-tuofangzhe-openclaw-phone-receipt": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-write, file-read, external-api, code-execution