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
- Create a free account
- Copy your API key from the dashboard
2. Set Your API Key
CODEBLOCK0
Or add to ~/.openclaw/openclaw.json:
CODEBLOCK1
Usage
Run /liveavatar to start the video avatar interface.
When the user runs this command:
- 1. Check if LIVEAVATARAPIKEY is set. If not, tell them:
> You need a LiveAvatar API key. Get one free at https://app.liveavatar.com
> Then set it: INLINECODE2
- 2. Launch the interface:
CODEBLOCK2
- 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
CODEBLOCK3
- 1. 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"
CODEBLOCK4
"No avatars available"
- - Check LIVEAVATARAPIKEY is set correctly
Voice not working
- - Allow microphone access in browser
- Check system audio settings
Links
OpenClaw LiveAvatar
为您的OpenClaw智能体赋予面容与声音！此技能可启动一个实时AI虚拟形象，您可通过麦克风与其自然对话。虚拟形象会聆听您的发言，将语音发送至OpenClaw智能体，并通过唇形同步视频回传应答内容。
由LiveAvatar实时AI虚拟形象技术驱动。
环境配置
1. 获取API密钥（免费）
- 1. 访问app.liveavatar.com
- 创建免费账户
- 从控制面板复制您的API密钥
2. 设置API密钥
bash
export LIVEAVATARAPIKEY=您的API密钥
或添加至~/.openclaw/openclaw.json：
json
{
skills: {
entries: {
liveavatar: {
env: {
LIVEAVATARAPIKEY: 您的API密钥
}
}
}
}
}
使用方法
运行/liveavatar启动视频虚拟形象界面。
当用户执行此命令时：
- 1. 检查LIVEAVATARAPIKEY是否已设置。若未设置，提示用户：
> 您需要LiveAvatar API密钥。免费获取：https://app.liveavatar.com
> 然后设置：export LIVEAVATAR
APIKEY=您的密钥
- 2. 启动界面：
bash
npx openclaw-liveavatar
- 3. 告知用户：
> 您的LiveAvatar界面正在启动，访问地址：http://localhost:3001
> 它将自动连接至您的OpenClaw网关。
>
> 提示：
> - 允许浏览器访问麦克风
> - 点击绿色麦克风按钮开始说话
> - 虚拟形象将用智能体的回答进行回应
> - 点击X按钮结束会话
工作原理
您说话 → 虚拟形象转写 → OpenClaw处理 → 虚拟形象语音回应
- 1. 语音输入：对着麦克风说话
- 语音转写：LiveAvatar将语音转换为文本
- 智能体处理：文本发送至OpenClaw网关（端口18789）
- 响应生成：智能体返回应答内容
- 虚拟形象语音：虚拟形象以自然唇形同步方式说话
功能特性
- - 实时视频虚拟形象，带表情动作
- 语音到语音对话
- 文本聊天备用选项
- 长回复智能TTS摘要
- 回声消除（不会自问自答）
- 多种虚拟形象可选
系统要求
- - 运行中的OpenClaw网关（openclaw gateway）
- LiveAvatar API密钥
- 支持麦克风的现代浏览器
- Node.js 18+
故障排除
OpenClaw连接断开
bash
openclaw gateway
无可用虚拟形象
- - 检查LIVEAVATARAPIKEY是否正确设置
语音无法工作
相关链接
