videochat-withme

与您的 OpenClaw 智能体进行实时视频通话——完整人格、记忆与视觉能力。

首次设置

新用户在安装该技能后仅需运行一次：

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

该脚本将自动完成全部配置：依赖安装、Groq API 密钥配置、SSL 证书生成、launchd 服务注册。

前置条件

• macOS（必须支持 launchd）
• Python 3.10+，ffmpeg
• 已运行 OpenClaw 网关，并启用 chatCompletions 功能

Groq API 密钥（语音识别必需）

1. 前往 https://console.groq.com/keys 免费获取密钥
2. 保存密钥：

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

   或设置环境变量：export GROQ_API_KEY="your-key-here"

启用 chatCompletions

在 ~/.openclaw/openclaw.json 中添加以下配置：

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

随后重启 OpenClaw。

使用方法（智能体操作指南）

当用户发起视频/语音通话请求时：

步骤 1：检查服务是否正在运行：

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

步骤 2：若无响应，则需执行初始化设置：

1. 检查 Groq 密钥是否存在：cat ~/.openclaw/secrets/groq_api_key.txt 2>/dev/null
   • 若缺失，请提示用户前往 https://console.groq.com/keys 获取密钥
   • 保存密钥：echo "key" > ~/.openclaw/secrets/groq_api_key.txt
2. 向用户询问：“您希望我在视频通话中如何称呼您？”
3. 运行自动化设置脚本：

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

步骤 3：根据上下文发起通话：

判断用户当前连接方式，并选择最优接入路径：

1. 用户位于电脑端（消息来自 webchat 或桌面客户端）：

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

   该命令将在 macOS 上弹出“来电通知” → 用户点击“接受” → 自动打开浏览器。

2. 用户处于移动端/远程环境（消息来自 Telegram 或手机）： 系统将自动选择最合适的 URL：

   # 优先使用 Tailscale IP（任意网络均可访问）
   TS_IP=$(tailscale ip -4 2>/dev/null)
   # 备用本地 IP（仅限同一 WiFi 网络）
   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)
   

   • 若检测到 Tailscale 可用 → 发送 https://:8766（全网可达）
   • 否则 → 发送 https://:8766（仅限同一 WiFi 网络）
   • 注意：首次访问需点击“高级 → 继续”以绕过自签名证书警告

架构概览

🎤 语音 → Groq Whisper（语音转文本，STT）
📷 摄像头 → base64 编码图像帧
    ↓
OpenClaw /v1/chat/completions → 您的智能体
    ↓
edge-tts（文本转语音，TTS） → 🔊 音频播放

脚本说明

智能体将自动执行以下脚本：

用户可在必要时手动执行以下脚本：

配置项