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.

1. 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)

```

• If Tailscale is available → send https://:8766 (works everywhere)
• Otherwise → send https://: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:

User can run manually if needed:

Configuration