LiveAvatar
Scanned@eNNNo
npx machina-cli add skill @eNNNo/liveavatar --openclawOpenClaw 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)
- 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
Links
- LiveAvatar - Real-time avatar platform
- OpenClaw - Your personal AI assistant
- GitHub - Source code
Overview
Gives your OpenClaw agent a face and voice with a real-time video avatar. Speak naturally into your microphone and have the avatar lip-sync to the agent's responses, creating a more engaging, human-like interaction.
How This Skill Works
You speak into your microphone and LiveAvatar transcribes your speech to text. The text is sent to the OpenClaw Gateway (port 18789) for processing, and the avatar speaks back with lip-synced video. The loop enables voice-to-voice conversations with optional text chat fallback.
When to Use It
- Demos or live support with a human-like face for your OpenClaw agent
- Voice-first conversations with natural, lip-synced responses
- Product demos, conferences, or pages needing a real-time avatar
- Brand-consistent avatars using multiple avatar options
- Text chat fallback when voice isn't available or preferred
Quick Start
- Step 1: Get an API key from app.liveavatar.com and export LIVEAVATAR_API_KEY
- Step 2: Start the avatar with `npx openclaw-liveavatar`
- Step 3: Open http://localhost:3001, grant microphone access, speak, and end session with the X button
Best Practices
- Set and securely store LIVEAVATAR_API_KEY before usage
- Ensure OpenClaw Gateway is running and accessible on port 18789
- Grant microphone access in the browser and test on a modern browser
- Use multiple avatar options to match branding and tone
- Leverage echo-cancellation and test lip-sync for natural responses
Example Use Cases
- Customer support avatar on a product page delivering answers with a friendly face
- Live onboarding tutor guiding users through setup with lip-synced replies
- Virtual receptionist in a storefront app handling inquiries
- Accessibility-focused assistant with a speaking avatar for visually impaired users
- Education module with a real-time avatar teaching a concept and answering questions
