OpenClaw �� 零成本为 OpenClaw 装上“耳朵”与“嘴巴”,一步到位的语音交互指南.

在 AI 助手普及的当下，语音交互已成为提升用户体验的核心能力。OpenClaw 作为强大的 AI 智能体平台，支持语音输入（STT，Speech To Text）与语音输出（TTS，Text To Speech）。本文介绍的配置方案完全免费，真正实现零成本让 OpenClaw 能听会说，并且对 OpenClaw 全局（即所有通道）有效。

先搞懂：语音功能是啥？

OpenClaw 的语音功能就是让 AI 说话给你听（TTS）和听懂你说的话（STT）。

举个例子：

• 你在手机上发一条语音："今天天气怎么样？"
• OpenClaw 把你的语音转成文字（STT）
• AI 回复一段文字
• OpenClaw 把文字转成语音发给你（TTS）

大部分情况，你只需要配置 TTS（让 AI 说话）就够了。

语音输出 Edge TTS（免费）

什么是 Edge TTS？

微软提供的免费语音服务，不需要注册、不需要 API Key，开箱即用。

支持哪些中文声音？

声音名	性别	特点
晓晓	女	温柔，适合日常对话
云扬	男	沉稳，适合朗读
晓伊	女	活泼，年轻感
云希	男	自然，适合通用场景

配置步骤

Step 1：打开配置文件

找到你的 OpenClaw 配置文件，通常在：

C:\Users\你的用户名\.openclaw\openclaw.json

Step 2：添加 TTS 配置

在配置文件的messages后面，加上以下这几行：

"messages": {"tts": {"auto":"inbound","provider":"microsoft","providers": {"microsoft": {"enabled":true,"voice":"zh-CN-XiaoxiaoNeural","lang":"zh-CN","outputFormat":"audio-24khz-48kbitrate-mono-mp3","rate":"+10%","pitch":"-5%"        }      }    }  },

参数解释：

• auto: "inbound" —— 只有你发语音，AI 才回语音
• provider: edge —— 用微软 Edge 的免费服务
• voice: zh-CN-XiaoxiaoNeural —— 用这个女声
• rate: +10% —— 控制语速（如 +10% 加快 10%）
• outputFormat —— 设置输出音频格式。
• pitch: -5% —— 控制音调（如 -5% 降低音调）

auto参数详解

off模式：完全关闭自动TTSalways模式：所有回复都带语音inbound模式：仅当收到语音消息时用语音回复（推荐）tagged模式：仅在回复包含 [[tts]] 标签时生成语音

Step 3：重启 OpenClaw

保存配置文件后，重启让配置生效：

openclaw gateway restart

Step 4：测试

• 打开你的聊天软件（飞书/微信/QQ等）
• 发一条语音消息给 OpenClaw
• 看看能不能收到语音回复
• 如果不回的用斜杠命令/tts on试一下。

语音输入（STT）

不需要配置，直接用通道的语音输入功能。

通道配置

QQ：支持接收和发送语音消息，需确保 Bot 有相应权限

飞书：支持语音输入输出功能

微信：QQ：支持接收和发送语音消息，需确保 Bot 有相应权限

常用斜杠命令

• /tts off: 关闭语音朗读
• /tts on: 开启语音朗读
• /tts status: 查看语音朗读状态
• /tts provider openai: 设置语音服务商为 OpenAI
• /tts limit 2000: 设置单次朗读字符上限为 2000
• /tts summary off: 关闭总结内容朗读（只朗读原文）
• /tts audio Hello from OpenClaw: 朗读音频：Hello from OpenClaw

常见问题

Q1：收不到语音回复？

检查清单：

• 配置文件保存了吗？
• OpenClaw 重启了吗？
• 你的聊天软件支持语音吗？
• auto: "inbound" 的话，你是发的语音吗？

Q2：Edge TTS 没声音？

可能原因：

• 声音名字错了（必须是"zh-CN-XiaoxiaoNeural"不是"xiaoxiao"）
• 网络问题（Edge TTS 需要联网）

Q3：能同时用多个渠道吗？

可以！不同渠道可以设置不同的 TTS：

{channels: {qqbot: {stt: {provider:"your-provider",model:"your-stt-model",      }     },openclaw-weixint: {stt: {provider:"your-provider",model:"your-stt-model",      }    },feishu: {stt: {provider:"your-provider",model:"your-stt-model",      }     }  }}