📞 callme.ai OpenClaw Plugin

Hands-free voice calls with your AI assistant - seamlessly integrated into OpenClaw

Talk naturally with Commodus using voice. No buttons, no typing. Just speak.

🚀 Quick Start

1. Get Your API Key

Sign up at callme.ai and get your API key from the dashboard.

2. Install Plugin

cd ~/.openclaw/plugins
git clone https://github.com/Benedict-VC/openclaw-voice.git callme
cd callme/plugin-callme
npm install

Or via npm (when published):

npm install -g @callme/openclaw-plugin

3. Configure OpenClaw

Add to your ~/.openclaw/config.yaml:

plugins:
  callme:
    enabled: true
    apiKey: "callme_your_key_here"  # Get from https://callme.ai/dashboard
    defaultVoice: "nova"             # optional: alloy, echo, fable, onyx, nova, shimmer
    language: "en"                   # optional: en, de, es, fr

4. Reload OpenClaw

openclaw reload

5. Start Calling!

/call              # Start a voice call
/call 5            # Call with 5-minute time limit
/voice-usage       # Check your usage stats
/voice-keys        # List your API keys

📋 Commands

| Command | Description | |---------|-------------| | /call [minutes] | Start a hands-free voice call | | /voice-setup | Show setup instructions | | /voice-usage | Display usage stats (minutes, cost, limits) | | /voice-keys | List your API keys |

⚙️ Configuration Options

plugins:
  callme:
    # Required
    apiKey: "callme_xxx"           # Your callme.ai API key
    
    # Optional
    defaultVoice: "nova"           # Voice: alloy, echo, fable, onyx, nova, shimmer
    language: "en"                 # Language: en, de, es, fr

💰 Pricing

• Free: 50 minutes/month
• Pro: 500 minutes/month - $19/month
• Enterprise: Unlimited - $99/month

View plans: callme.ai/#pricing

🔧 How It Works

You speak → callme.ai (STT) → OpenClaw Session → Claude → callme.ai (TTS) → You hear

1. Voice Activity Detection - Automatically detects when you stop speaking
2. Real-time Processing - Sub-2-second response time
3. Seamless Integration - Uses your active OpenClaw session
4. Usage Tracking - Automatically tracked per API key

🛠️ Development

Local Testing

cd plugin-callme
npm install
npm test

Environment Variables

export CALLME_API_BASE="http://localhost:3000"
export CALLME_WS_BASE="ws://localhost:3000"

📖 Examples

Basic Call

/call
# Speaks naturally, conversation ends when you stop talking

Time-Limited Call

/call 10
# Automatic cutoff after 10 minutes

Check Usage

/voice-usage
# Shows: calls, minutes used, remaining quota, cost

Manage Keys

/voice-keys
# Lists all your API keys with status and expiry

🔒 Security

• API keys are stored securely in OpenClaw config
• Never log or expose keys in plain text
• All connections use TLS encryption
• Keys can be revoked anytime at dashboard

🐛 Troubleshooting

"API key not configured"

/voice-setup
# Follow the setup instructions

"Monthly limit reached"

Check usage:

/voice-usage

Upgrade plan at: https://callme.ai/dashboard

"WebSocket connection failed"

1. Check your internet connection
2. Verify API key is valid
3. Check callme.ai status page

📚 Documentation

• API Reference: https://docs.callme.ai/api
• OpenClaw Docs: https://docs.openclaw.ai
• Support: https://discord.com/invite/clawd

📄 License

MIT © callme.ai