openclaw 配置语音代理
方案概述
Openclaw 作为 HA 语音管道的 LLM 代理层,当 HA 内置意图匹配失败时接管处理。
定位
在语音处理流程中的角色:
用户语音 → linux-voice-assistant → HA 语音管道
│
┌───────────┴───────────┐
│ 意图匹配成功 │ 意图匹配失败
▼ ▼
执行设备命令 Openclaw (LLM 代理)
│
调用大模型理解意图
│
通过 HA MCP 操控设备
│
生成自然语言回复
│
▼
HA 语音管道 → TTS
│
TTS 音频返回卫星
│
▼
linux-voice-assistant 扬声器播出
核心功能
| 功能 | 说明 |
|---|---|
| 意图兜底 | HA 意图匹配失败时,接手处理用户原文 |
| 自然语言理解 | 调用配置的大模型(LLM)理解模糊/复合/闲聊指令 |
| 设备操控 | 通过 HA MCP 协议标准化调用 HA 服务 |
| 回复生成 | 将执行结果转为口语化回复,交给 TTS 播报 |
关键技术:HA MCP
HA MCP(Home Assistant Model Context Protocol)是连接 LLM 与 HA 的桥梁:
- 标准化接口:以 MCP 协议暴露 HA 的设备和服务
- 设备发现:LLM 可列出所有 HA 设备和实体
- 服务调用:LLM 可直接调用 HA 服务(开关灯、设置温度等)
- 状态查询:LLM 可查询设备当前状态
部署配置
- 项目地址:nichloasx/openclaw
- 依赖:需要配置 LLM API(如 OpenAI 兼容接口)
- MCP 连接:配置 HA MCP 服务地址和认证