videochat-withme

Real-time video call with your OpenClaw agent — full personality, memory, and vision.

First-Time Setup

New users run once after installing the skill:

bash skills/videochat-withme/scripts/setup.sh

This handles everything: dependencies, Groq API key, SSL certs, launchd service.

Prerequisites

• macOS (launchd required)
• Python 3.10+, ffmpeg
• OpenClaw gateway running with chatCompletions enabled

Groq API Key (required for voice recognition)

1. Get a free key at: https://console.groq.com/keys
2. Save it:

   mkdir -p ~/.openclaw/secrets
   echo "your-key-here" > ~/.openclaw/secrets/groq_api_key.txt
   

   Or set env var: export GROQ_API_KEY="your-key-here"

Enable chatCompletions

Add to ~/.openclaw/openclaw.json:

{
  "gateway": {
    "http": {
      "endpoints": {
        "chatCompletions": { "enabled": true }
      }
    }
  }
}

Then restart OpenClaw.

How to Use (Agent Instructions)

When the user requests a video/voice call:

Step 1: Check if service is running:

curl -sk https://localhost:8766/api/config 2>/dev/null || curl -s http://localhost:8766/api/config 2>/dev/null

Step 2: If no response, setup needed:

1. Check Groq key: cat ~/.openclaw/secrets/groq_api_key.txt 2>/dev/null
   • If missing, ask user to get one at https://console.groq.com/keys
   • Save it: echo "key" > ~/.openclaw/secrets/groq_api_key.txt
2. Ask user: "What name should I display for you in the video call?"
3. Run setup:

   bash skills/videochat-withme/scripts/setup.sh --auto --agent-name "YourName" --user-name "TheirName"
   

Step 3: Initiate the call based on context:

Determine how the user is connecting and pick the best method:

1. User is at the computer (message from webchat/desktop):

   bash skills/videochat-withme/scripts/call.sh
   

   This pops up a macOS incoming call notification → user clicks Accept → browser opens.

2. User is on mobile/remote (message from Telegram/phone): Pick the right URL automatically:

   # Prefer Tailscale IP (works from any network)
   TS_IP=$(tailscale ip -4 2>/dev/null)
   # Fallback to local IP (same WiFi only)
   LOCAL_IP=$(python3 -c "import socket; s=socket.socket(socket.AF_INET,socket.SOCK_DGRAM); s.connect(('8.8.8.8',80)); print(s.getsockname()[0]); s.close()" 2>/dev/null)
   

   • If Tailscale is available → send https://<tailscale-ip>:8766 (works everywhere)
   • Otherwise → send https://<local-ip>:8766 (same WiFi only)
   • Note: first visit requires tapping "Advanced → Continue" (self-signed cert)

Architecture

🎤 Voice → Groq Whisper (STT)
📷 Camera → base64 frame
    ↓
OpenClaw /v1/chat/completions → Your Agent
    ↓
edge-tts (TTS) → 🔊 Audio playback

Scripts

Agent runs these automatically:

| Script | When | |--------|------| | setup.sh --auto | First use (service not running) | | call.sh | Every call request |

User can run manually if needed:

| Script | Purpose | |--------|---------| | setup.sh | Interactive setup (without --auto) | | start.sh | Start service | | stop.sh | Stop service |

Configuration

| Variable | Default | Description | |----------|---------|-------------| | GROQ_API_KEY | (secrets file) | Groq API key for Whisper STT | | PORT | 8766 | Server port | | AGENT_NAME | AI Assistant | Display name for the agent | | USER_NAME | User | Display name for the user | | SSL_CERT | (auto-detect) | Path to SSL certificate | | SSL_KEY | (auto-detect) | Path to SSL private key |