小米 TTS Proxy

音色与风格控制

预置音色（voice 参数）

风格控制（input 文本开头加 <style> 标签）

将 <style>风格</style> 置于待合成文本开头，小米的 TTS 会识别并应用对应风格：

样例：

curl -X POST http://127.0.0.1:18899/audio/speech \
  -d '{"input":"<style>东北话</style>哎呀妈呀，这天儿也太冷了！","voice":"mimo_default","response_format":"opus"}'

技能简介

本技能在本地启动一个 HTTP 代理服务（默认 :18899），将 OpenAI TTS API 格式请求转换为小米大模型平台 TTS API（api.xiaomimimo.com），并支持 FFmpeg 硬件转码为 Opus/MP3/AAC/FLAC/WAV/PCM 等格式。

适用场景：为 OpenClaw 配置语音合成、搭建通用 TTS 代理服务。

使用前提

• FFmpeg 已安装（ffmpeg -version 确认）
• 拥有小米大模型平台 API Key
• 建议 Node.js ≥ 18（代理使用原生 fetch）

首次配置（交互式）

首次使用本技能时，需要完成以下配置步骤：

步骤 1：配置环境变量

创建或更新 ~/.openclaw/tts-proxy.env 文件，内容如下：

# 小米 TTS API 配置
MIMO_TTS_BASE=https://api.xiaomimimo.com
MIMO_TTS_KEY=你的_小米API_Key
TTS_PROXY_PORT=18899

注意：MIMO_TTS_BASE 不要包含 /v1 后缀，代理会自动添加。 如果使用代理转发小米 API（解决国内访问问题），在 MIMO_TTS_BASE 中填写代理地址。

步骤 2：安装 Systemd 服务（可选但推荐）

代理通过 systemd 服务运行，可实现开机自启和自动管理。

复制服务单元文件并注册：

sudo cp mimo-tts-proxy.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now mimo-tts-proxy.service
sudo systemctl status mimo-tts-proxy.service

步骤 3：验证运行状态

curl http://127.0.0.1:18899/health
# 应返回：{"status":"ok","provider":"mimo-v2-tts"}

步骤 4：配置 OpenClaw TTS

在 OpenClaw 配置中（~/.openclaw/openclaw.json），找到或添加 messages.tts 节点：

{
  "messages": {
    "tts": {
      "auto": "inbound",
      "provider": "openai",
      "providers": {
        "openai": {
          "baseUrl": "http://127.0.0.1:18899",
          "apiKey": "not-needed",
          "model": "tts-1",  # 占位值，代理实际固定使用 mimo-v2-tts
          "voice": "mimo_default"
        }
      }
    }
  }
}

配置后重启 OpenClaw Gateway 使配置生效。

服务管理命令

API 端点

POST /audio/speech

与 OpenAI TTS API 格式兼容：

curl -X POST http://127.0.0.1:18899/audio/speech \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tts-1",
    "input": "<style>开心</style>你好，这是中文语音测试",
    "voice": "mimo_default",
    "response_format": "opus"
  }' \
  -o output.opus

参数说明：

支持的输出格式：

GET /health

健康检查：

curl http://127.0.0.1:18899/health
# → {"status":"ok","provider":"mimo-v2-tts"}

故障排查

健康检查失败

systemctl status mimo-tts-proxy.service
journalctl -u mimo-tts-proxy.service -n 50 --no-pager

返回 404 或 502

1. 确认 MIMO_TTS_BASE 不带 /v1 后缀（代理自动添加）
2. 确认 MIMO_TTS_KEY 正确且有 TTS 配额
3. 检查上游小米 API 是否可达：

   curl -X POST https://api.xiaomimimo.com/v1/chat/completions \
     -H "Content-Type: application/json" \
     -H "api-key: 你的Key" \
     -d '{"model":"mimo-v2-tts","messages":[{"role":"assistant","content":"test"}],"audio":{"format":"wav","voice":"mimo_default"}}'
   

音频格式问题

如果播放无声，确认使用 opus 格式（飞书/微信等平台的要求）。wav 格式在某些平台可能不兼容。

配额耗尽

{"error":{"code":"429","message":"monthly quota exhausted"}}

小米 TTS 月度配额用完，需要到小米大模型平台购买增量包或等待下月重置。

文件位置