介绍
# OpenClaw LiveAvatar
为你的 OpenClaw 智能体赋予面容和声音！此技能会启动一个实时 AI 化身，你可以通过麦克风自然地与它对话。化身会聆听你的声音，将你的语音发送给 OpenClaw 智能体，并通过口型同步的视频朗读回复内容。
由 [LiveAvatar](https://liveavatar.com) 提供支持——实时 AI 化身技术。
## 设置
### 1. 获取你的 API 密钥（免费）
1. 访问 [app.liveavatar.com](https://app.liveavatar.com) 2. 创建一个免费账户 3. 从控制台复制你的 API 密钥
### 2. 设置你的 API 密钥
```bash export LIVEAVATAR_API_KEY=your_api_key_here ```
或将其添加到 `~/.openclaw/openclaw.json` 中：
```json { "skills": { "entries": { "liveavatar": { "env": { "LIVEAVATAR_API_KEY": "your_api_key_here" } } } } } ```
## 使用方法
运行 `/liveavatar` 启动视频化身界面。
当用户运行此命令时：
1. **检查是否设置了 LIVEAVATAR_API_KEY**。如果没有，提示他们： > 你需要一个 LiveAvatar API 密钥。在 https://app.liveavatar.com 免费获取一个 > 然后设置它：`export LIVEAVATAR_API_KEY=your_key`
2. **启动界面**： ```bash npx openclaw-liveavatar ```
3. **告知用户**： > 你的 LiveAvatar 界面正在 http://localhost:3001 启动 > 它将自动连接到你的 OpenClaw 网关。 > > 提示： > - 出现提示时允许麦克风访问 > - 点击绿色麦克风按钮开始说话 > - 化身将朗读你的智能体的回复 > - 点击 X 按钮结束会话
## 工作原理
``` You speak → Avatar transcribes → OpenClaw processes → Avatar speaks response ```
1. **语音输入**：对着麦克风说话 2. **转录**：LiveAvatar 将语音转换为文本 3. **智能体处理**：文本发送到 OpenClaw 网关（端口 18789） 4. **响应**：返回智能体回复 5. **化身语音**：化身通过自然的口型同步朗读内容
## 功能特点
- 带有表情的实时视频化身 - 端到端语音对话 - 文本聊天备选方案 - 针对长回复的智能 TTS 摘要 - 回声消除（不会响应自己的声音） - 多种化身选择
## 系统要求
- OpenClaw 网关正在运行 (`openclaw gateway`) - LiveAvatar API 密钥 - 支持麦克风功能的现代浏览器 - Node.js 18+
## 故障排查
**“OpenClaw Disconnected”** ```bash openclaw gateway ```
**“No avatars available”** - 检查 LIVEAVATAR_API_KEY 是否设置正确
**语音无法工作** - 在浏览器中允许麦克风访问 - 检查系统音频设置
## 链接
- [LiveAvatar](https://liveavatar.com) - 实时化身平台 - [OpenClaw](https://openclaw.ai) - 你的个人 AI 助手 - [GitHub](https://github.com/eNNNo/openclaw-liveavatar) - 源代码