- name
- videochat-withme
- description
- |
- Requires
- GROQ_API_KEY for speech recognition. Reads ~/.openclaw/openclaw.json for gateway port and auth token.
- metadata
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.shThis 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)
- Get a free key at: https://console.groq.com/keys
- Save it:
mkdir -p ~/.openclaw/secrets
echo "your-key-here" > ~/.openclaw/secrets/groq_api_key.txtOr 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/nullStep 2: If no response, setup needed:
- 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
- Ask user: "What name should I display for you in the video call?"
- 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:
- User is at the computer (message from webchat/desktop):
bash skills/videochat-withme/scripts/call.shThis pops up a macOS incoming call notification → user clicks Accept → browser opens.
- 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 playbackScripts
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 |