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: bash 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 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 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: bash # 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)

3. If Tailscale is available → send https://<tailscale-ip>:8766 (works everywhere)
4. Otherwise → send https://<local-ip>:8766 (same WiFi only)
5. 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:

User can run manually if needed:

Configuration