callme-openclaw-plugin 1.0.0

package/README.md

@@ -0,0 +1,196 @@
+# 📞 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](https://callme.ai) and get your API key from the dashboard.
+
+### 2. Install Plugin
+
+```bash
+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):
+```bash
+npm install -g @callme/openclaw-plugin
+```
+
+### 3. Configure OpenClaw
+
+Add to your `~/.openclaw/config.yaml`:
+
+```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
+
+```bash
+openclaw reload
+```
+
+### 5. Start Calling!
+
+```bash
+/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
+
+```yaml
+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](https://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
+
+```bash
+cd plugin-callme
+npm install
+npm test
+```
+
+### Environment Variables
+
+```bash
+export CALLME_API_BASE="http://localhost:3000"
+export CALLME_WS_BASE="ws://localhost:3000"
+```
+
+---
+
+## 📖 Examples
+
+### Basic Call
+```bash
+/call
+# Speaks naturally, conversation ends when you stop talking
+```
+
+### Time-Limited Call
+```bash
+/call 10
+# Automatic cutoff after 10 minutes
+```
+
+### Check Usage
+```bash
+/voice-usage
+# Shows: calls, minutes used, remaining quota, cost
+```
+
+### Manage Keys
+```bash
+/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"
+```bash
+/voice-setup
+# Follow the setup instructions
+```
+
+### "Monthly limit reached"
+Check usage:
+```bash
+/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

package/index.js

@@ -0,0 +1,255 @@
+/**
+ * callme.ai OpenClaw Plugin
+ * Hands-free voice calls with your AI assistant
+ */
+
+const WebSocket = require('ws');
+const fetch = require('node-fetch');
+
+const API_BASE = process.env.CALLME_API_BASE || 'https://callme.ai/api';
+const WS_BASE = process.env.CALLME_WS_BASE || 'wss://callme.ai/ws';
+
+class CallmePlugin {
+  constructor(config, openclaw) {
+    this.config = config;
+    this.openclaw = openclaw;
+    this.apiKey = config.apiKey;
+    
+    if (!this.apiKey) {
+      throw new Error('callme.ai API key not configured. Run /voice-setup');
+    }
+  }
+  
+  /**
+   * Start a voice call
+   */
+  async startCall(duration = null) {
+    if (!this.apiKey) {
+      return {
+        error: true,
+        message: '❌ API key not configured. Get yours at https://callme.ai/dashboard'
+      };
+    }
+    
+    try {
+      // Verify API key & get user info
+      const userResponse = await fetch(`${API_BASE}/auth/me`, {
+        headers: {
+          'Authorization': `Bearer ${this.apiKey}`
+        }
+      });
+      
+      if (!userResponse.ok) {
+        throw new Error('Invalid API key');
+      }
+      
+      const userData = await userResponse.json();
+      const user = userData.data.user;
+      
+      // Check usage limits
+      const usageResponse = await fetch(`${API_BASE}/usage/current`, {
+        headers: {
+          'Authorization': `Bearer ${this.apiKey}`
+        }
+      });
+      
+      const usageData = await usageResponse.json();
+      const usage = usageData.data;
+      
+      if (!usage.withinLimit) {
+        return {
+          error: true,
+          message: `❌ Monthly limit reached (${usage.limit} minutes). Upgrade at https://callme.ai/dashboard`
+        };
+      }
+      
+      // Connect to WebSocket
+      const ws = new WebSocket(WS_BASE, {
+        headers: {
+          'Authorization': `Bearer ${this.apiKey}`
+        }
+      });
+      
+      return new Promise((resolve, reject) => {
+        ws.on('open', () => {
+          ws.send(JSON.stringify({
+            type: 'start_call',
+            voice: this.config.defaultVoice || 'nova',
+            language: this.config.language || 'en',
+            duration: duration
+          }));
+          
+          resolve({
+            success: true,
+            message: '📞 Call started! Speak naturally, I\'m listening...',
+            ws: ws,
+            user: user,
+            usage: usage
+          });
+        });
+        
+        ws.on('error', (error) => {
+          reject(new Error(`WebSocket error: ${error.message}`));
+        });
+      });
+      
+    } catch (error) {
+      return {
+        error: true,
+        message: `❌ Failed to start call: ${error.message}`
+      };
+    }
+  }
+  
+  /**
+   * Get usage stats
+   */
+  async getUsage() {
+    try {
+      const response = await fetch(`${API_BASE}/usage/current`, {
+        headers: {
+          'Authorization': `Bearer ${this.apiKey}`
+        }
+      });
+      
+      if (!response.ok) {
+        throw new Error('Failed to fetch usage');
+      }
+      
+      const data = await response.json();
+      return data.data;
+      
+    } catch (error) {
+      throw new Error(`Failed to get usage: ${error.message}`);
+    }
+  }
+  
+  /**
+   * List API keys
+   */
+  async listKeys() {
+    try {
+      const response = await fetch(`${API_BASE}/keys`, {
+        headers: {
+          'Authorization': `Bearer ${this.apiKey}`
+        }
+      });
+      
+      if (!response.ok) {
+        throw new Error('Failed to fetch keys');
+      }
+      
+      const data = await response.json();
+      return data.data.keys;
+      
+    } catch (error) {
+      throw new Error(`Failed to list keys: ${error.message}`);
+    }
+  }
+}
+
+/**
+ * Plugin initialization
+ */
+module.exports = {
+  name: '@callme/openclaw-plugin',
+  version: '1.0.0',
+  
+  /**
+   * Initialize plugin
+   */
+  async init(config, openclaw) {
+    const plugin = new CallmePlugin(config, openclaw);
+    
+    // Register /call command
+    openclaw.registerCommand('call', async (args) => {
+      const duration = args[0] ? parseInt(args[0]) : null;
+      const result = await plugin.startCall(duration);
+      
+      if (result.error) {
+        return result.message;
+      }
+      
+      return `${result.message}\n\n📊 Usage: ${result.usage.minutesUsed.toFixed(1)}/${result.usage.limit} min used this month`;
+    });
+    
+    // Register /voice-setup command
+    openclaw.registerCommand('voice-setup', async () => {
+      return `🔧 **Setup callme.ai Voice**
+
+1. Get your API key at: https://callme.ai/dashboard
+2. Add it to your OpenClaw config:
+
+   \`\`\`yaml
+   plugins:
+     callme:
+       apiKey: "callme_your_key_here"
+       defaultVoice: "nova"  # optional
+       language: "en"        # optional
+   \`\`\`
+
+3. Reload OpenClaw: \`openclaw reload\`
+4. Start calling: \`/call\`
+
+Need help? Check the docs: https://docs.callme.ai/openclaw`;
+    });
+    
+    // Register /voice-usage command
+    openclaw.registerCommand('voice-usage', async () => {
+      try {
+        const usage = await plugin.getUsage();
+        
+        return `📊 **callme.ai Usage**
+
+**This Month:**
+• Calls: ${usage.calls}
+• Minutes: ${usage.minutesUsed.toFixed(1)} / ${usage.limit}
+• Cost: $${usage.cost.toFixed(2)}
+• Remaining: ${usage.remaining.toFixed(1)} min
+
+**Plan:** ${usage.tier}
+
+Upgrade or view details: https://callme.ai/dashboard`;
+      } catch (error) {
+        return `❌ ${error.message}`;
+      }
+    });
+    
+    // Register /voice-keys command
+    openclaw.registerCommand('voice-keys', async () => {
+      try {
+        const keys = await plugin.listKeys();
+        
+        if (keys.length === 0) {
+          return `🔑 **API Keys**
+
+No keys found. Create one at: https://callme.ai/dashboard`;
+        }
+        
+        const keysList = keys.map(key => {
+          const expiry = key.expiresAt 
+            ? new Date(key.expiresAt).toLocaleDateString() 
+            : 'Never';
+          const status = key.isExpired ? '❌ Expired' : '✅ Active';
+          const lastUsed = key.lastUsedAt 
+            ? new Date(key.lastUsedAt).toLocaleDateString() 
+            : 'Never';
+          
+          return `• **${key.name}**
+  ${key.keyPreview}
+  ${status} · Expires: ${expiry} · Last used: ${lastUsed}`;
+        }).join('\n\n');
+        
+        return `🔑 **API Keys**
+
+${keysList}
+
+Manage keys: https://callme.ai/dashboard`;
+      } catch (error) {
+        return `❌ ${error.message}`;
+      }
+    });
+    
+    return plugin;
+  }
+};

package/install.sh

@@ -0,0 +1,65 @@
+#!/bin/bash
+# callme.ai One-Command Installer for OpenClaw
+# Usage: curl -fsSL https://callme.ai/install.sh | bash
+
+set -e
+
+PLUGIN_DIR="$HOME/.openclaw/plugins/callme"
+CONFIG_FILE="$HOME/.openclaw/config.yaml"
+PLUGIN_URL="https://raw.githubusercontent.com/Benedict-VC/openclaw-voice/main/plugin-callme"
+
+echo "📞 Installing callme.ai voice plugin for OpenClaw..."
+
+# Create plugin directory
+mkdir -p "$PLUGIN_DIR"
+
+# Download plugin files
+echo "📥 Downloading plugin..."
+curl -fsSL "$PLUGIN_URL/package.json" -o "$PLUGIN_DIR/package.json"
+curl -fsSL "$PLUGIN_URL/index.js" -o "$PLUGIN_DIR/index.js"
+
+# Install dependencies
+echo "📦 Installing dependencies..."
+cd "$PLUGIN_DIR"
+npm install --silent 2>/dev/null || npm install
+
+# Check if config.yaml exists
+if [ ! -f "$CONFIG_FILE" ]; then
+    echo "⚠️  No config.yaml found. Creating one..."
+    mkdir -p "$(dirname "$CONFIG_FILE")"
+    cat > "$CONFIG_FILE" << 'EOF'
+plugins:
+  callme:
+    enabled: true
+    apiKey: "YOUR_API_KEY_HERE"
+    defaultVoice: "nova"
+    language: "en"
+EOF
+else
+    # Check if callme plugin already in config
+    if ! grep -q "callme:" "$CONFIG_FILE"; then
+        echo "⚙️  Adding callme plugin to config..."
+        cat >> "$CONFIG_FILE" << 'EOF'
+
+# callme.ai Voice Plugin
+plugins:
+  callme:
+    enabled: true
+    apiKey: "YOUR_API_KEY_HERE"
+    defaultVoice: "nova"
+    language: "en"
+EOF
+    fi
+fi
+
+echo ""
+echo "✅ callme.ai plugin installed successfully!"
+echo ""
+echo "📋 Next steps:"
+echo "1. Get your API key at: https://callme.ai/dashboard"
+echo "2. Add it to: $CONFIG_FILE"
+echo "   Replace 'YOUR_API_KEY_HERE' with your actual key"
+echo "3. Reload OpenClaw: openclaw reload"
+echo "4. Start calling: /call"
+echo ""
+echo "Need help? Check: https://docs.callme.ai/openclaw"

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "callme-openclaw-plugin",
+  "version": "1.0.0",
+  "description": "OpenClaw plugin for callme.ai - hands-free voice calls with your AI assistant",
+  "main": "index.js",
+  "bin": {
+    "callme-setup": "./setup.js"
+  },
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "voice",
+    "ai",
+    "calls",
+    "callme"
+  ],
+  "author": "callme.ai",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Benedict-VC/openclaw-voice.git"
+  },
+  "openclaw": {
+    "displayName": "callme.ai Voice",
+    "description": "Make hands-free voice calls to your AI assistant",
+    "category": "communication",
+    "commands": [
+      {
+        "name": "/call",
+        "description": "Start a voice call with your AI assistant",
+        "usage": "/call [duration]"
+      },
+      {
+        "name": "/voice-setup",
+        "description": "Configure your callme.ai API key",
+        "usage": "/voice-setup"
+      }
+    ],
+    "config": {
+      "apiKey": {
+        "type": "string",
+        "description": "Your callme.ai API key (from dashboard)",
+        "required": true,
+        "secret": true
+      },
+      "defaultVoice": {
+        "type": "string",
+        "description": "Default voice (alloy, echo, fable, onyx, nova, shimmer)",
+        "default": "nova"
+      },
+      "language": {
+        "type": "string",
+        "description": "Language code (en, de, es, fr)",
+        "default": "en"
+      }
+    }
+  },
+  "dependencies": {
+    "ws": "^8.16.0",
+    "node-fetch": "^2.7.0"
+  }
+}

package/setup.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+/**
+ * Interactive callme.ai setup for OpenClaw
+ * Run: npx @callme/setup
+ */
+
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+const readline = require('readline');
+const { exec } = require('child_process');
+const { promisify } = require('util');
+
+const execAsync = promisify(exec);
+
+const PLUGIN_DIR = path.join(process.env.HOME, '.openclaw', 'plugins', 'callme');
+const CONFIG_FILE = path.join(process.env.HOME, '.openclaw', 'config.yaml');
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout
+});
+
+function question(query) {
+  return new Promise(resolve => rl.question(query, resolve));
+}
+
+function download(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(dest);
+    https.get(url, (response) => {
+      response.pipe(file);
+      file.on('finish', () => {
+        file.close();
+        resolve();
+      });
+    }).on('error', (err) => {
+      fs.unlink(dest, () => {});
+      reject(err);
+    });
+  });
+}
+
+async function main() {
+  console.log('\n📞 \x1b[1mcallme.ai Setup for OpenClaw\x1b[0m\n');
+  
+  // Step 1: Check if OpenClaw is installed
+  console.log('🔍 Checking OpenClaw installation...');
+  try {
+    await execAsync('which openclaw');
+    console.log('✅ OpenClaw found\n');
+  } catch (error) {
+    console.log('❌ OpenClaw not found. Install it first: npm install -g openclaw');
+    process.exit(1);
+  }
+  
+  // Step 2: Get API Key
+  console.log('🔑 \x1b[1mGet your API key:\x1b[0m https://callme.ai/dashboard\n');
+  const apiKey = await question('Paste your API key: ');
+  
+  if (!apiKey || !apiKey.startsWith('callme_')) {
+    console.log('\n❌ Invalid API key format. Must start with "callme_"');
+    process.exit(1);
+  }
+  
+  // Step 3: Download plugin
+  console.log('\n📥 Downloading plugin...');
+  fs.mkdirSync(PLUGIN_DIR, { recursive: true });
+  
+  const files = [
+    { name: 'package.json', url: 'https://raw.githubusercontent.com/Benedict-VC/openclaw-voice/main/plugin-callme/package.json' },
+    { name: 'index.js', url: 'https://raw.githubusercontent.com/Benedict-VC/openclaw-voice/main/plugin-callme/index.js' }
+  ];
+  
+  for (const file of files) {
+    await download(file.url, path.join(PLUGIN_DIR, file.name));
+  }
+  console.log('✅ Plugin downloaded');
+  
+  // Step 4: Install dependencies
+  console.log('\n📦 Installing dependencies...');
+  process.chdir(PLUGIN_DIR);
+  await execAsync('npm install --silent');
+  console.log('✅ Dependencies installed');
+  
+  // Step 5: Update config
+  console.log('\n⚙️  Updating OpenClaw config...');
+  
+  const configContent = `
+# callme.ai Voice Plugin
+plugins:
+  callme:
+    enabled: true
+    apiKey: "${apiKey}"
+    defaultVoice: "nova"
+    language: "en"
+`;
+  
+  if (fs.existsSync(CONFIG_FILE)) {
+    const existing = fs.readFileSync(CONFIG_FILE, 'utf8');
+    if (existing.includes('callme:')) {
+      // Replace existing
+      const updated = existing.replace(
+        /plugins:\s*\n\s*callme:[\s\S]*?(?=\n\S|$)/,
+        configContent.trim()
+      );
+      fs.writeFileSync(CONFIG_FILE, updated);
+    } else {
+      // Append
+      fs.appendFileSync(CONFIG_FILE, configContent);
+    }
+  } else {
+    fs.mkdirSync(path.dirname(CONFIG_FILE), { recursive: true });
+    fs.writeFileSync(CONFIG_FILE, configContent);
+  }
+  console.log('✅ Config updated');
+  
+  // Step 6: Done!
+  console.log('\n✨ \x1b[1;32mSetup complete!\x1b[0m\n');
+  console.log('📋 Next steps:');
+  console.log('  1. Reload OpenClaw: \x1b[36mopenclaw reload\x1b[0m');
+  console.log('  2. Start calling: \x1b[36m/call\x1b[0m');
+  console.log('');
+  console.log('📚 Commands:');
+  console.log('  /call              - Start voice call');
+  console.log('  /voice-usage       - Check usage stats');
+  console.log('  /voice-keys        - Manage API keys');
+  console.log('');
+  console.log('Need help? https://docs.callme.ai/openclaw');
+  console.log('');
+  
+  rl.close();
+}
+
+main().catch((error) => {
+  console.error('\n❌ Setup failed:', error.message);
+  process.exit(1);
+});