如何把小智语音对话机器人和 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的全新升级版👇：
1. 基本原理
小智设备与 OpenClaw 通信，采用 异步消息转发 模式，整体流程如下：
小智设备 ──(MCP)──> 小智Pro服务端 ──(HTTP)──> OpenClaw Gateway
│
小智设备 <──(推送)── 小智Pro服务端 <──(Redis 缓存)──────┘
1.1 消息发送
- 用户对小智说出指令（如"让欧克劳帮我发一条飞书消息"）
- 设备端通过
self.openclaw.send 将消息发送到小智Pro服务端 - 服务端收到后立即返回确认，将实际请求放入后台任务异步执行
- 后台任务调用
OpenClaw Gateway 的 API，等待回复
1.2 回复投递
OpenClaw 返回结果后，服务端会：
- 缓存回复：将回复内容存入 Redis，多条回复自动拼接，5分钟自动过期
- 设备在听（listening）：发送指令通知设备取消息
- 设备在说（speaking）：自动等待，等待结束后再通知取消息
- 设备取消息：设备收到通知后，主动调用 retrieve 接口获取缓存的回复
- 取完即删：回复被读取后立即从 Redis 删除，确保消息不重复消费
1.3 关键设计
2. 操作指南
2.0 OpenClaw 配置示例
确保 OpenClaw Gateway 监听在公网可访问的地址和端口，并配置了 Token 认证。
找到 OpenClaw 的配置文件：~/.openclaw/openclaw.json
重点关注以下三个配置项：
"gateway": {
"http": {
"endpoints": {
"chatCompletions": { "enabled": true }
}
},
"tools": {
"allow": ["sessions_send"]
},
"mode": "local",
"auth": {
"mode": "token",
"token": "xxx"
},
"port": 18789,
"bind": "loopback",
},
"session": {
"dmScope": "per-channel-peer",
},
"tools": {
"profile": "full",
"exec": {
"security": "full",
"ask": "off"
},
"sessions": {
"visibility": "all"
}
}
具体说明：
- gateway.http 配置：允许 API 调用
- gateway.tools.allow：允许
sessions_send 工具，以便小智Pro服务端通过该工具将消息发送到指定会话 - tools.profile = "full" — 所有工具都允许
- sessions.visibility = "all" — 支持跨会话查看
2.1 小智Pro控制台配置 OpenClaw
前往小智Pro控制台：https://mkwyqeoebedx.sealosbja.site
左侧菜单 设备端MCP → OpenClaw，首次使用需配置连接：
- Gateway URL：OpenClaw Gateway 的地址，如
http://your-ip:18789 - Agent：默认对话的智能体名称，如
main，连接成功后支持切换智能体
配置完成后，页面顶部会显示：
你也可以随时点击 检查连接 按钮重新检测，或点击删除按钮清除配置。
2.2 配置Tab - 切换和小智对话的智能体
配置Tab，展示小智和OpenClaw的专属会话：
- SessionKey：固定为
openai-user:xiaozhi-pro:{用户ID}，即小智设备对话时使用的会话
注：这里记录小智设备和OpenClaw的专属会话，你可以在前端查看 / 测试对话内容，和OpenClaw控制台对话记录同步。
2.3 聊天Tab - 浏览其他会话
切换到 聊天Tab，可以浏览 OpenClaw 的所有会话：
- 选择智能体：刷新智能体列表，从下拉框中选择一个 Agent
- 选择会话：选定智能体后，刷新会话列表并选择一个会话
- 会话详情：选中会话后，右侧显示该会话的渠道、模型、Token用量、状态等信息
- 发送消息：在选中会话的输入框中输入消息并发送，和
OpenClaw控制台对话记录同步。
2.4 通过设备语音操控
注：设备固件版本需为 v2.2.5.1 以上：https://github.com/hougeai/xiaozhiPro/releases
配置好 OpenClaw 连接后，你可以直接对小智说：
- '问问欧克劳现在都有哪些定时任务'
- '让欧克劳给我的飞书发一条消息'
- '让欧克劳立刻完成今天的AI资讯整理任务'
成功调用后，屏幕或日志中会看到 self.openclaw.send 工具调用，欧克劳回复后，服务端会自动推送到设备，设备随即播报回复内容。
3. 常见问题
连接状态显示异常？
- 检查 Gateway URL 是否正确，确保格式为
http://ip:port 或 https://domain.com - 确认 OpenClaw Gateway 服务正常运行
设备端没有收到欧克劳的回复？
- 回复会在5分钟后自动过期，如果设备长时间未取消息则无法获取
- 如果设备正在说话，服务端会自动等待（最多25秒），等待结束后再推送
发送消息后没有反应？
- OpenClaw 的回复是异步处理的，消息发送后需要等待 Gateway 响应
- 如果 Gateway 响应较慢，请耐心等待或检查 OpenClaw 服务状态
发送消息提示异常？
- 参考 2.0 节的配置示例，确保 OpenClaw 的配置项正确设置，特别是工具权限和认证方式
4. 效果展示
比如，让修一下定时任务失败的问题：
回到 Openclaw 控制台，看小智和Openclaw的对话记录：
比如，让打开浏览器查查今日热搜：
写在最后
本文分享了小智Pro：让小智控制 OpenClaw的全新升级方案。
如果对你有帮助，不妨点赞收藏备用。
欢迎体验 小智Pro 更多功能，请戳👇：
https://mkwyqeoebedx.sealosbja.site
注：控制 OpenClaw能力需设备端固件v2.2.5.1版。
固件已全面适配小智官方仓库收录的开发板型号，下载地址：
https://github.com/hougeai/xiaozhiPro/releases
粤ICP备14082021号
免费POC，
零成本试错
