LiveAvatar

Powered by [LiveAvatar](https://liveavatar.com) - real-time AI avatar technology.

## Setup

### 1. Get Your API Key (Free)

1. Go to [app.liveavatar.com](https://app.liveavatar.com)
2. Create a free account
3. Copy your API key from the dashboard

### 2. Set Your API Key

```bash
export LIVEAVATAR_API_KEY=your_api_key_here
```

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

```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**:
   ```bash
   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"**
```bash
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

- [LiveAvatar](https://liveavatar.com) - Real-time avatar platform
- [OpenClaw](https://openclaw.ai) - Your personal AI assistant
- [GitHub](https://github.com/eNNNo/openclaw-liveavatar) - Source code