让你的小龙虾🦞会说话

OpenClaw 是一款开源 AI 助手框架。它的 messages.tts.openai 配置块支持任意 OpenAI 兼容的 TTS 接口——而 ListenHub 的 /v1/tts 正好满足这一要求。

将 OpenClaw 接入 ListenHub，你的 AI 助手就能开口说话：在支持语音消息的平台上，回复将以语音气泡的形式发送，使用 ListenHub 丰富的多语言音色。

前置条件

OpenClaw v2026.3.7 及以上版本
一个 ListenHub API Key
拥有足够积分的 ListenHub 账户（详见积分与定价）

配置

在你的 openclaw.json 的 messages 字段下添加以下配置：

{
  "messages": {
    "tts": {
      "auto": "always",
      "provider": "openai",
      "openai": {
        "baseUrl": "https://api.marswave.ai/openapi/v1",
        "apiKey": "$LISTENHUB_API_KEY",
        "model": "flowtts",
        "voice": "CN-Man-Beijing-V2"
      }
    }
  }
}

将 $LISTENHUB_API_KEY 替换为你在账户设置中创建的 API Key，将 voice 替换为你从音色列表中选取的任意音色 ID。flowtts 是 ListenHub 的 TTS 模型名称，保持不变即可。

用 curl 快速验证

接入 OpenClaw 之前，可以先用以下命令验证 API Key 是否可用：

curl -X POST https://api.marswave.ai/openapi/v1/audio/speech \
    -H "Authorization: Bearer $LISTENHUB_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "input": "今天天气真不错，适合出去散步。",
      "voice": "chat-girl-105-cn",
      "response_format": "mp3",
      "model": "flowtts"
    }' \
    --output output.mp3

成功后，output.mp3 会保存到当前目录。将 voice 替换为音色列表 API 中的任意音色 ID 即可切换音色。

`auto` 模式说明

auto 字段控制何时对回复触发语音转换：

值	行为
`"always"`	所有回复均转换为语音
`"inbound"`	仅当收到的消息本身是语音消息时，才以语音回复
`"tagged"`	仅当回复内容包含 `[[tts]]` 指令时才转换
`"off"`	关闭自动语音转换

"inbound" 模式非常适合 Telegram：对方发语音，你也回语音。

可用音色

ListenHub 提供多语言自然音色，以下是几个常用示例：

音色 ID	语言	性别
`chat-girl-105-cn`	普通话	女声
`CN-Man-Beijing-V2`	普通话	男声
`EN-Man-General-01`	英语	男声
`EN-Woman-General-01`	英语	女声
`EN-Man-General-01`	英语	男声

完整音色列表请通过音色列表 API 查询。

平台语音消息支持

以下平台支持原生语音消息投递：

平台	支持情况
Telegram	✅ 圆形语音气泡
Discord	✅ 语音消息
WhatsApp	✅ 语音消息
飞书 / Lark	❌ 暂不支持语音消息
Slack	❌ 仅支持音频文件附件