Voice
Moss Live
By MOSS-Live 全双工实时语音 provider，接入 OpenClaw Talk | Realtime speech-to-speech provider for OpenClaw via api.mosi.cn (full-duplex, tool calls, barge-in)
Install
npm install
##Configuration Example
{
"talk": {
"realtime": {
"transport": "gateway-relay",
"providers": {
"moss-live": {
"apiKey": "（可留空，留空则读 ~/.openclaw/moss_api_key.txt）",
"model": "moss-live-1.0",
"voiceName": "",
"personaName": "",
"personaPrompt": ""
}
}
}
}
}README
# openclaw-plugin-moss-live
把 [MOSS-Live](https://www.mosi.cn) 全双工实时语音接入 [OpenClaw](https://github.com/openclaw/openclaw) 的 Talk 实时对话——让没有 OpenAI Realtime / Google Live key 的环境也能用上中文实时语音助手。
  
> 🌐 **English**: A MOSS-Live realtime voice provider plugin for OpenClaw — full-duplex speech-to-speech over `wss://api.mosi.cn/v1/realtime`, with tool calls, barge-in and playback pacing. Works with OpenClaw Talk (Control UI) via `gateway-relay` transport.
## 为什么需要它
OpenClaw 的 Talk 实时语音原生对接 OpenAI Realtime / Google Live，这类服务在国内网络与支付环境下并不好拿。MOSS-Live 是官方提供付费 API 的中文全双工语音服务（`api.mosi.cn`，需自行充值申请 key），本插件把它封装成 OpenClaw 标准的 realtime voice provider，**Talk 界面里选一下就能用**。
## 特性
- **全双工语音对话**：说话即打断（barge-in 双向处理），24kHz PCM 上下行
- **原生工具调用**：OpenClaw 注册的 function tools 自动透传给 MOSS 会话，结果自动回填
- **播放配速（关键设计）**：每个音频块带 `audio-N` mark 回执 + 虚拟播放时钟，按真实播放进度向 MOSS 发 `playback.chunk.completed`，连续输出不掐断、不积压
- **persona / instructions 透传**：宿主下发的系统指令、persona 名与提示词映射到 MOSS `session.update`
- **断线与超时兜底**：WS 15s 连接超时、15s 心跳、异常关闭自动上报宿主
- 零依赖打包：复用 OpenClaw 自带 `ws`，无需额外 npm install
## 安装
```bash
# 1. 放到 OpenClaw 插件源码目录
git clone https://github.com/caoruidong-1979/openclaw-moss-live.git \
~/.openclaw/plugins-src/moss-live
# 2. 写入你的 API key（去 mosi.cn 官网申请，自费充值）
echo -n "你的key" > ~/.openclaw/moss_api_key.txt
chmod 600 ~/.openclaw/moss_api_key.txt
```
## 配置
`~/.openclaw/openclaw.json`：
```json
{
"talk": {
"realtime": {
"transport": "gateway-relay",
"providers": {
"moss-live": {
"apiKey": "（可留空，留空则读 ~/.openclaw/moss_api_key.txt）",
"model": "moss-live-1.0",
"voiceName": "",
"personaName": "",
"personaPrompt": ""
}
}
}
}
}
```
然后重启网关（`systemctl --user restart openclaw-gateway`），在 Control UI 的 Talk 里选择 **MOSS-Live 全双工语音** 即可。
| 配置项 | 说明 |
|---|---|
| `apiKey` | 留空则读取 `~/.openclaw/moss_api_key.txt` |
| `baseUrl` | 默认 `wss://api.mosi.cn/v1/realtime`，一般不用改 |
| `model` | 默认 `moss-live-1.0` |
| `voiceName` | 音色名，空 = 服务端默认 |
| `personaName` / `personaPrompt` | 人设名/提示词，映射到 MOSS persona |
## 工作原理
```
OpenClaw Talk (浏览器/Control UI)
│ gateway-relay
▼
OpenClaw 网关 ── 本插件 (RealtimeVoiceBridge)
│ wss + Bearer
▼
api.mosi.cn /v1/realtime (MOSS-Live)
```
- 上行音频：宿主 pcm16/24k → 线性插值重采样 16k → 二进制帧
- 下行音频：MOSS 原生 24k 直通，每块挂 mark；宿主确认或虚拟时钟到点即回执
- 打断（用户插话）：双向同步——宿主 barge-in 与 MOSS `response.interrupted` 都会取消当前 run 并解除占用
实测环境：树莓派 5（8G）+ OpenClaw 2026.11.x + Control UI Talk。
## Roadmap
- [ ] **遥控器联动**：配合 [无线麦Mod](https://github.com/caoruidong-1979/windows-remote-mic-app)（Chromecast 遥控器 → Windows），按住遥控器语音键直接与 OpenClaw 对话——把电视遥控器变成客厅 AI 助手的实体按钮
- [ ] 音色/人设预设管理
- [ ] 配置校验与连接自检命令
## 相关项目
- [windows-remote-mic-app（无线麦Mod）](https://github.com/caoruidong-1979/windows-remote-mic-app) — 谷歌 Chromecast 遥控器 → Windows 快捷操作与语音输入
## 声明
- 本插件需要自行在 MOSS 官网申请并充值 API key，**本项目不包含、也不会索要任何人的密钥**
- 本项目为社区第三方插件，与 MOSS / OpenClaw 官方无隶属关系
- 使用产生的费用由使用者自行承担
## License
[MIT](LICENSE)
voice
Comments
Sign in to leave a comment