360 Secure SkillHub
360 安全技能中心

LiveAvatar

通过 npx openclaw-liveavatar 启动本地视频头像界面(localhost:3001),需设置 LIVEAVATAR_API_KEY 并运行 OpenClaw Gateway。用户在浏览器授权麦克风后语音对话,语音经 LiveAvatar 转写后交给 OpenClaw 智能体,回答以带口型同步的语音视频返回。

ennno
ennno
热度 98.04
最近更新 2026-05-11 15:53:17
分类:自动化依赖:代码执行 / 联网浏览搜索 / 第三方 API应用场景:工作流

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add liveavatar
Metadata
name
liveavatar
description
Talk face-to-face with your OpenClaw agent using a real-time video avatar powered by LiveAvatar
user-invocable
true
metadata
{"openclaw":{"emoji":"🎭","requires":{"env":["LIVEAVATAR_API_KEY"],"bins":["node","npm"]},"install":[{"id":"node","kind":"node","package":"openclaw-liveavatar","bins":["openclaw-liveavatar"],"label":"Install LiveAvatar (npm)"}]}}

OpenClaw LiveAvatar

Give your OpenClaw agent a face and voice! This skill launches a real-time AI avatar that you can talk to naturally using your microphone. The avatar listens to you, sends your speech to your OpenClaw agent, and speaks the response back with lip-synced video.

Powered by LiveAvatar - real-time AI avatar technology.

Setup

1. Get Your API Key (Free)

  1. Go to app.liveavatar.com
  2. Create a free account
  3. Copy your API key from the dashboard

2. Set Your API Key

export LIVEAVATAR_API_KEY=your_api_key_here

Or add to ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "liveavatar": {
        "env": {
          "LIVEAVATAR_API_KEY": "your_api_key_here"
        }
      }
    }
  }
}

Usage

Run /liveavatar to start the video avatar interface.

When the user runs this command:

  1. Check if LIVEAVATAR_API_KEY is set. If not, tell them:

    You need a LiveAvatar API key. Get one free at https://app.liveavatar.com Then set it: export LIVEAVATAR_API_KEY=your_key

  2. Launch the interface:

    npx openclaw-liveavatar
    
  3. Tell the user:

    Your LiveAvatar interface is starting at http://localhost:3001 It will connect automatically to your OpenClaw Gateway.

    Tips:

    • Allow microphone access when prompted
    • Click the green mic button to speak
    • The avatar will respond with your agent's answers
    • Click the X button to end the session

How It Works

You speak → Avatar transcribes → OpenClaw processes → Avatar speaks response
  1. Voice Input: Speak into your microphone
  2. Transcription: LiveAvatar converts speech to text
  3. Agent Processing: Text sent to OpenClaw Gateway (port 18789)
  4. Response: Agent response returned
  5. Avatar Speech: Avatar speaks with natural lip-sync

Features

  • Real-time video avatar with expressions
  • Voice-to-voice conversations
  • Text chat fallback option
  • Smart TTS summarization for long responses
  • Echo cancellation (won't respond to itself)
  • Multiple avatar choices

Requirements

  • OpenClaw Gateway running (openclaw gateway)
  • LiveAvatar API key
  • Modern browser with microphone
  • Node.js 18+

Troubleshooting

"OpenClaw Disconnected"

openclaw gateway

"No avatars available"

  • Check LIVEAVATAR_API_KEY is set correctly

Voice not working

  • Allow microphone access in browser
  • Check system audio settings

Links