Source Code

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.

Setup

1. Get Your API Key (Free)

Go to app.liveavatar.com
Create a free account
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:

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
Launch the interface:
```
npx openclaw-liveavatar
```
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

Voice Input: Speak into your microphone
Transcription: LiveAvatar converts speech to text
Agent Processing: Text sent to OpenClaw Gateway (port 18789)
Response: Agent response returned
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

liveavatar