如何把小智语音对话机器人和 openclaw 打通?
OpenClaw 是异步处理:收到消息 → 网关处理 → 一段时间后返回回复。
这种模式天然适合文字聊天(如 IM),但不适合语音对话的实时交互需求。
小智采用实时语音通信协议,要求低延迟、即时响应。
直接对接 OpenClaw 的异步接口会导致:
- 用户说话后长时间无反馈,体验割裂
- 语音打断、上下文同步困难
因此,需设计中间层,来管理 OpenClaw 的异步任务。
前文分享过一种实现思路:
MCP连接海量Skills,24H在线打工人它来了" data-itemshowtype="0" linktype="text" data-linktype="2">小智Pro:让小智控制 OpenClaw,一个MCP连接海量Skills,24H在线打工人它来了
但这种设计,要维护两个 WebSocket 连接:
- 前端 ↔ 后端,用于接收前端指令、推送 OpenClaw 的流式响应。
- 后端 ↔
OpenClaw Gateway,用于和 OpenClaw 服务保持长连接,收发消息。
假设有 N 个活跃用户,就得 2N 条 WebSocket 连接,资源占用高。
怎么搞?
今日分享,聊聊:小智控制OpenClaw的全新升级版👇:
- 平台侧:和
OpenClaw的异步通信的基本原理 - 用户侧:接入并管理
OpenClaw的操作指南
1. 基本原理
小智设备与OpenClaw 通信,采用 异步消息转发 模式,整体流程如下:
小智设备 ──(MCP)──> 小智Pro服务端 ──(HTTP)──> OpenClaw Gateway │小智设备 <──(推送)── 小智Pro服务端 <──(Redis 缓存)──────┘
1.1 消息发送
- 用户对小智说出指令(如"让欧克劳帮我发一条飞书消息")
- 设备端通过
self.openclaw.send将消息发送到小智Pro服务端 - 服务端收到后立即返回确认,将实际请求放入后台任务异步执行
- 后台任务调用
OpenClaw Gateway的 API,等待回复
1.2 回复投递
OpenClaw 返回结果后,服务端会:
- 缓存回复:将回复内容存入 Redis,多条回复自动拼接,5分钟自动过期
- 感知设备状态:查询设备当前对话状态
- 设备在听(listening):发送指令通知设备取消息
- 设备空闲(idle):先唤醒设备,再通知取消息
-
设备在说(speaking):自动等待,等待结束后再通知取消息
-
设备取消息:设备收到通知后,主动调用 retrieve 接口获取缓存的回复
- 取完即删:回复被读取后立即从 Redis 删除,确保消息不重复消费
1.3 关键设计
| 特性 | 说明 |
|---|---|
| 异步响应 | 发送消息后立即返回,不阻塞设备对话 |
| 消息防丢 | 多条回复追加拼接,不会互相覆盖 |
| 可靠投递 | 根据设备状态智能选择推送时机 |
| 原子操作 | 读取回复使用原子操作,避免重复消费 |
| ## 2. 操作指南 | |
| ### 2.0 OpenClaw 配置示例 | |
> 确保 OpenClaw Gateway 监听在公网可访问的地址和端口,并配置了 Token 认证。 |
|
找到 OpenClaw 的配置文件:~/.openclaw/openclaw.json |
|
| 重点关注以下三个配置项: |
"gateway": { "http": { "endpoints": { "chatCompletions": { "enabled": true } } }, "tools": { "allow": ["…— 以上为试看内容(约 40%),开通会员后阅读全文 —