1. 全网语音玩法都在折腾什么1.1 为什么非要让它开口不可OpenClaw 我上手用了一段时间整体观感是这框架干活的底子很厚能看、能读、能操作但默认状态就是个哑巴。它把任务做完了只会往终端里打一行文字。你要是人不在电脑前面或者手上正忙着别的事就只能回头翻日志才知道它刚才干了什么。这个体验在跑长任务、批处理、或者把它挂在后台当个人助理的时候格外难受。你不可能一直盯着屏幕刷输出语音就成了一种性价比极高的反馈通道——任务完成了给你报一声出错了一次性念出来甚至每天早上的信息汇总直接放成一段语音。很多人说这是锦上添花我实际用下来觉得这是刚需尤其是 OpenClaw 这种偏“无人值守”的自动化代理声音是它跟人之间最自然的一条交互链路。1.2 主流的四类玩法把网上各路折腾语音的文章翻了一圈本质上大家走的路子可以归成四种。第一种是接云端语音合成接口。效果最好音色接近真人支持各种情感和音色定制。缺点是基本都要注册账号、申请凭证、配置密钥免费额度有限而且每次合成都要发网络请求离线场景直接趴窝。第二种是部署本地大模型语音合成。音质也很顶甚至能模仿特定嗓音但模型体积动辄几个 GB 到十几个 GB还往往要求较好的显卡才能实时合成。OpenClaw 本身已经要占用不少内存和算力再叠一套大模型普通机器基本就吃不消了。第三种是轻量开源语音库。这类方案比较取巧合成速度不错离线可用依赖也不算太重。但不同平台的安装还真挺看脸有些仓库源不更新有些需要自己编译中文发音质量参差不齐折腾时间往往远超预期。第四种就是系统内置语音引擎。Windows、macOS、主流桌面 Linux 其实都自带了文本转语音能力通过一条命令就能调用。不需要装额外模型不需要注册任何账号离线可用启动速度极快。缺点是音色偏“机械”没有任何花哨的情感表达但做代理的语音结果播报完全够用。1.3 选型之前我先给自己立了三条规矩因为踩过不少“方案很好但落不了地”的坑这次我没有直接抄作业而是先定了一个选型标准。第一是免费。这话听起来像废话但实际上不少方案宣传的时候说是免费用两天就发现免费额度只够尝鲜或者核心功能藏在付费档位里。我只接受从下载到日常使用都不用付费的方案。第二是 3 分钟内能跑通。OpenClaw 这种框架本身配置就不算简单如果再引入一个要配环境变量、下载模型、处理 CUDA 依赖的语音方案等于给自己挖坑。我要的是一条“改一行配置、写一个脚本”就能出声音的路径。第三是长期维护风险低。所谓风险低就是说这个方案不要太依赖某个服务商的政策变化也不要依赖某个社区项目会不会断更。系统内置语音引擎是操作系统自己的功能只要不重装系统它就在那里天然满足这个条件。这三条标准一卡我的选择其实已经很明确了。2. 为什么我最终选了“系统内置TTS”这个野路子2.1 四种方案摆一起看看对比数据有时候比看长篇评测更直观我把自己实际测下来的感觉整理成了下面这张表。对比维度云端语音合成本地大模型轻量开源库系统内置TTS音质听感最接近真人很接近真人中等偏机械首次安装成本注册 配置密钥下载模型 配环境装依赖 调参数零安装离线可用否是是是运行时资源占用低网络开销除外很高中低极低中文发音表现很好好参差系统自带语音包可用长期可靠性看服务商脸色看项目更新看社区维护系统不挂它就在我当时把这表发给一个朋友看他回了一句话“你这选项分析做得跟相亲似的。”但事实就是这样OpenClaw 要的是稳定输出不是选美。你要真让我在“云端方案偶尔抽风”和“系统方案永远在线”之间选我肯定选后者。2.2 系统TTS到底是怎么工作的很多人一听“系统内置语音引擎”就觉得是 Chrome 朗读网页那种简陋玩意儿其实它的底层是操作系统级的声音合成能力。Windows 上有一套完整的语音合成接口macOS 自带的语音引擎也可以直接读文本Linux 桌面发行版基本都有预装的命令行语音工具。这些引擎的工作流程大体上就是你把一段文本丢给它它内部通过语音合成引擎把文本拆成音素再根据内置的发音词典和韵律模型生成音频数据最后交给声卡播放。整个过程在本地完成不产生任何网络流量。听起来好像没什么技术含量但对 OpenClaw 这种场景来说技术含量恰恰不重要。它在乎的是你能不能稳定地叫它发出声音而不是它能不能念出一段带情绪的散文。一条系统命令一个文本参数输出直接落到扬声器上这就是最符合“代理”气质的语音方案。2.3 音质确实不行但我要的根本不是音质我承认第一耳朵听到系统 TTS 的声音时确实有一股“电子客服”那味儿。但仔细想一下OpenClaw 的主要语音场景是什么是结果播报、状态提醒、任务摘要不是给你唱摇篮曲。你要让代理帮你查个天气、跑个脚本、汇总一份报告回来的时候用语音把结论读给你听。这种信息密度很高的播报对音色的要求其实没那么苛刻。反而能听清楚、不吞字、不莫名卡顿才是真正的核心体验。而且系统 TTS 有一个云方案替代不了的优势播放是即时的。云端方案再快也要走一轮 HTTP 请求断网的时候直接没辙。本地模型再厉害也要跑一次推理。系统 TTS 基本是按下去就响跟 CPU 打一个字母出一个字符一样这种即时反馈在连续对话场景里太重要了。3. 三分钟落地实操让 OpenClaw 开口说话3.1 第一步写一个零依赖的语音脚本我这里用一个跨平台的 Python 脚本做示例它只调用系统自带的语音引擎不需要 pip 装任何包。写法也比较直白你把它保存成/opt/openclaw/scripts/speak.py就能用。import sys import subprocess import platform def speak(text): text text.strip() if not text: return system platform.system() if system Windows: # Windows 走 PowerShell 自带的语音合成对象 # 建议把下面的命令单独存成 speak.ps1 再调用避免每次转义麻烦 ps_script Add-Type -AssemblyName System.Speech; \ $s New-Object System.Speech.Synthesis.SpeechSynthesizer; \ $s.Speak($args[0]); subprocess.Popen([powershell, -NoProfile, -Command, ps_script, text]) elif system Darwin: # macOS 直接用 say 命令 subprocess.Popen([say, text]) else: # Linux 一般用 espeak-ng部分发行版可能需要先安装 subprocess.Popen([espeak-ng, -v, zh, text]) if __name__ __main__: if len(sys.argv) 1: speak(sys.argv[1])如果你用的是 Windows也可以更干脆一点把 PowerShell 脚本独立保存成speak.ps1# speak.ps1 Add-Type -AssemblyName System.Speech $s New-Object System.Speech.Synthesis.SpeechSynthesizer $s.Speak($args[0])然后调用powershell -NoProfile -ExecutionPolicy Bypass -File speak.ps1 你好。这样省掉了嵌套引号的烦恼调用也更稳定。Linux 上如果提示找不到espeak-ng用系统包管理器装一下就好。这也算是全过程中唯一可能需要主动安装的组件其他都是系统自带。3.2 第二步把语音脚本挂到 OpenClaw 输出钩子上OpenClaw 这类框架一般都会在关键节点暴露事件回调或者自定义命令的入口。有的版本支持在配置文件里直接挂外部命令有的版本需要你在包装脚本里手动调用。我用的方式是在配置文件里加一段自定义输出处理把所有最终回复统一转给语音脚本。下面是一个典型的配置示意具体的键名会随版本不同有差异但思路是一致的voice: enabled: true # 触发时机代理生成最终回复之后 event: reply.final # 把回复文本作为参数传给外部脚本 command: [python3, /opt/openclaw/scripts/speak.py] # 不阻塞主流程避免声音还没播完代理就等在那 async: true这里最关键的一个参数是async: true。它让语音播放在后台进行主线程继续处理后面的任务。不然就会出现一种很蠢的情况代理每说一句话整个流程都要等声音念完再继续长回复能卡死你几分钟。如果你的版本没有现成的event配置也不用慌。OpenClaw 的输出日志一般是可以拦截的你在入口处加一层薄薄的包装脚本读取代理返回的文本然后调用上面的speak.py效果完全一样。我自己最早就是从“监听输出流”这种方式起步的后来为了统一配置才换到事件钩子。3.3 第三步配置音色、语速、音量的正确姿势系统 TTS 默认的音色一般比较中庸但可以通过参数微调。Windows 的SpeechSynthesizer自带多个系统语音包你可以先列出来看看有哪些可用Add-Type -AssemblyName System.Speech $s New-Object System.Speech.Synthesis.SpeechSynthesizer $s.GetInstalledVoices() | ForEach-Object { $_.VoiceInfo.Name }macOS 的say支持用-v参数切换音色比如中文语音包一般是-v Tingting。Linux 的espeak-ng可以用-v zh选中文还能用-s调整语速、-a调整音量。我实际调下来语速比默认慢一点点听起来会更清楚。Windows 里Rate默认是 0范围从 -10 到 10设成 -1 或者 -2 会舒服很多。macOS 的say默认语速偏慢我反而会稍微调快一档。Linux 的espeak-ng默认语速偏快我通常用-s 150左右。这里给一个我调整过的参数版本照着用就行def speak(text): text text.strip() if not text: return system platform.system() if system Windows: ps_script Add-Type -AssemblyName System.Speech; \ $s New-Object System.Speech.Synthesis.SpeechSynthesizer; \ $s.Rate -1; \ $s.Volume 90; \ $s.Speak($args[0]); subprocess.Popen([powershell, -NoProfile, -Command, ps_script, text]) elif system Darwin: subprocess.Popen([say, -r, 200, text]) else: subprocess.Popen([espeak-ng, -v, zh, -s, 150, -a, 90, text])3.4 从“哑巴”到“开口说话”的完整验证流程配置改完验证是最重要的。我第一次配完以为成了结果发现 OpenClaw 的日志里确实调用了脚本但整个系统只有日志没有声音排查了半天才发现是执行用户没有访问音频设备的权限。我建议按下面的顺序测每一步都单独确认先用命令行直接测语音脚本本身比如python3 speak.py 你好这是测试声音。如果这一步没声音后面 OpenClaw 怎么调都不会有先解决系统层面的问题。然后测配置文件里的事件绑定。故意让 OpenClaw 执行一个简单的任务比如让它打印一句话看看终端里是否出现调用 speak.py 的记录。如果事件没触发多半是事件名或者命令路径写错了。最后测完整链路。跑一个稍微有实际内容的任务让它播报整个回复。这时候要重点观察任务结束前声音有没有播完有没有卡在后台以及多次播放有没有占满 CPU。整套流程走下来正常也就一杯茶的功夫。4. 常见问题与排查实录4.1 第一个问题永远是为什么没声音我把语音方案分享给几个朋友后收到的反馈里至少有七成都是“没声音”。而且大家的问题还真不太一样有的简单有的隐蔽我整理了一个排查顺序供参考。现象可能原因处理方式命令行直接跑就没声音系统音量静音、输出设备不对先调系统音量确认默认播放设备命令行有声音OpenClaw 调用后没声音脚本路径错误或事件没触发检查配置里的 command 路径手动执行一次确认调用后终端有报错但听不到声音当前用户没有音频设备权限把执行用户加入 audio 组或改用桌面会话运行声音断断续续播放与主线程互相抢占资源保持异步播放必要时增加播放队列服务器上有声音设备但实际无声卡系统没有物理输出口配置虚拟声卡或把音频转发到局域网设备如果你是在一台无头服务器上跑 OpenClaw没有插音箱也没有输出设备那它确实没法发出声音来。这个不算故障是物理条件限制解决思路可以看后面的第四节。4.2 中文吞字、读错字怎么救系统 TTS 在朗读中文的时候偶尔会出现吞字、读错多音字、或者把标点也念出来的问题。这些大多数时候不是 bug是语音包的发音词典不够全。Windows 上如果你发现中文读得很怪先检查当前选中的是不是中文语音包。有些系统默认选了一个英文语音包遇到中文字符会逐字硬拼听起来就非常折磨。切成Microsoft Huihui或者Microsoft Kangkang这类中文语音包就好了。macOS 上中文语音包的名字一般会带明显的拼音后缀比如Tingting。如果你听到的是满口英文腔读中文大概率是音色选错了。Linux 的 espeak-ng 对中文的支持比较看语音包质量。个别情况下会遇到声调不准、词语断句错乱我试过换用别的语音包之后明显改善。实在不行也可以给 OpenClaw 的输出加一层简单的文本预处理把容易读错的缩写、数字、英文单词替换成更口语化的中文表达。4.3 长文本卡住阻塞、爆音和超时OpenClaw 有时候一口气会输出一大段回复直接丢给语音引擎容易有两个后果。一个是播放时间太长把整个任务流程拖住另一个是文本里包含大量特殊字符语音引擎处理起来会莫名卡死。解决办法就是拆分。不要让语音引擎一次性处理整段长文本而是按句子切分成小块逐块播放。中文可以按句号、感叹号、问号切分英文按句点和换行切分。我写了一个小函数做这件事import re def speak_long(text): # 按中英文句子结束符分块 parts re.split(r(?[。!?]), text) for part in parts: if part.strip(): speak(part) # 给每一小段之间留一点自然停顿 import time time.sleep(0.15)这样既不会出现一句没说完就被掐断的情况也不会因为文本太长导致语音引擎内部缓冲溢出。比硬喂整段文本稳得多。4.4 服务器没声卡让它说给谁听很多人跑 OpenClaw 的地方不是自己的电脑而是云服务器或者家里的 NAS。这种环境往往没有声卡甚至整个系统就是无头模式。没有音频设备你让 TTS 播给谁听我的经验是两条路线。一条是给系统装一个虚拟声卡让语音输出到音频流里再通过网络串流到手机或者电脑上播放。比如 PulseAudio 提供空输出模块配合局域网音频转发工具就能把服务器上的声音传到你的桌面端。这个方案配置稍微绕一点但胜在稳定。另一条更简单既然服务器没有声卡那就别在服务器上发声把文本转成音频文件然后推送到你的设备上。很多即时通讯工具的 Webhook 接口或者自建的消息推送通道都能够接收文件这样 OpenClaw 生成一段语音文件后直接推送给你在手机上随时可以听。本质上还是那些免费消息通道不需要额外花钱。这两条路线我目前更推荐后者理由就一句话你对“消息送达”的掌控力更强。本地播放受网络和硬件影响的因素太多推送文件反而是一种从端到端的可靠路径。5. 会说话之后还能怎么玩5.1 给 OpenClaw 加上“耳朵”有了“嘴”很自然会想再给它配个“耳朵”。让 OpenClaw 听懂你说话本质上就是把语音转文字STT之后再送进它的对话入口。免费思路也有几条。最省事的是借助浏览器自带的语音识别接口你打开一个本地网页对着麦克风说话它把文字转出来之后通过本地接口扔给 OpenClaw。这种方案无需额外装模型适合轻量交互场景。如果你想要离线而且更可控可以在本地跑一个开源语音识别模型把麦克风采集到的音频实时转写。这个方案的资源占用比系统 TTS 高不少但对于已经跑 OpenClaw 的机器来说只要不是太老配置通常能接受。给 OpenClaw 加上输入通道之后它的使用场景就从“单向播报代理”变成了“双手解放的语音助手”。我在本地就是这么干的问一句“现在几点了”它转成文字后自己去查再用语音念结果回来闭环体验非常顺手。5.2 多角色切换系统 TTS 虽然音色选择有限但也不是只有一种。Windows 和 macOS 都内置了不止一个语音包可以按场景切换使用。我给 OpenClaw 配了两套音色日常任务播报用一个普通中文音色任务出错或者需要强调的紧急提醒用另一个明显不同的音色。这样你不用看屏幕光靠声音就能判断代理汇报的是好消息还是坏消息。多音色还有一个隐藏好处就是当你同时跑多个代理实例的时候每个实例用不同音色区分不会混在一起听不出是谁在说话。配置上其实很简单在语音脚本里增加一个参数OpenClaw 调用时根据事件类型传进来不同的音色标识。比如python3 speak.py 备份任务已完成 --voice default python3 speak.py 备份任务失败请检查磁盘 --voice alert5.3 定时播报与任务通知OpenClaw 本身就有很强的任务调度能力配上语音之后很多“定时”玩法就顺理成章了。比如每天早上定时跑一个信息汇总任务然后把结果用语音播报出来或者每天晚上定时检查磁盘空间、备份状态有异常才开口正常就保持沉默。这种玩法对资源配置非常友好因为语音本身只在关键时刻才触发平时就是零成本待机。你别看它简单实际用起来特别提升体验——代理不再是屏幕上一个冷冰冰的进程而是会主动跟你打招呼、会提醒你该干嘛的生活管家。我后来还在语音脚本里加了缓存处理对同一个任务在短时间内的重复播报直接跳过避免代理因为循环任务反复念同一句话。这个优化思路可以扩展一下任何重复性、模板化的播报都值得做一层去重不然连续被同一个声音轰炸几次之后再新鲜的功能也会让人烦躁。玩到这里OpenClaw 已经从“能干活但没声”变成了“既能干活又会说话”关键是整条链路没有花一分钱也没有引入任何随时可能失效的外部依赖。如果你手头也有一台跑着 OpenClaw 的机器不妨照着上面的步骤试一次大概率会比你想的更顺利。
1. 全网语音玩法都在折腾什么1.1 为什么非要让它开口不可OpenClaw 我上手用了一段时间整体观感是这框架干活的底子很厚能看、能读、能操作但默认状态就是个哑巴。它把任务做完了只会往终端里打一行文字。你要是人不在电脑前面或者手上正忙着别的事就只能回头翻日志才知道它刚才干了什么。这个体验在跑长任务、批处理、或者把它挂在后台当个人助理的时候格外难受。你不可能一直盯着屏幕刷输出语音就成了一种性价比极高的反馈通道——任务完成了给你报一声出错了一次性念出来甚至每天早上的信息汇总直接放成一段语音。很多人说这是锦上添花我实际用下来觉得这是刚需尤其是 OpenClaw 这种偏“无人值守”的自动化代理声音是它跟人之间最自然的一条交互链路。1.2 主流的四类玩法把网上各路折腾语音的文章翻了一圈本质上大家走的路子可以归成四种。第一种是接云端语音合成接口。效果最好音色接近真人支持各种情感和音色定制。缺点是基本都要注册账号、申请凭证、配置密钥免费额度有限而且每次合成都要发网络请求离线场景直接趴窝。第二种是部署本地大模型语音合成。音质也很顶甚至能模仿特定嗓音但模型体积动辄几个 GB 到十几个 GB还往往要求较好的显卡才能实时合成。OpenClaw 本身已经要占用不少内存和算力再叠一套大模型普通机器基本就吃不消了。第三种是轻量开源语音库。这类方案比较取巧合成速度不错离线可用依赖也不算太重。但不同平台的安装还真挺看脸有些仓库源不更新有些需要自己编译中文发音质量参差不齐折腾时间往往远超预期。第四种就是系统内置语音引擎。Windows、macOS、主流桌面 Linux 其实都自带了文本转语音能力通过一条命令就能调用。不需要装额外模型不需要注册任何账号离线可用启动速度极快。缺点是音色偏“机械”没有任何花哨的情感表达但做代理的语音结果播报完全够用。1.3 选型之前我先给自己立了三条规矩因为踩过不少“方案很好但落不了地”的坑这次我没有直接抄作业而是先定了一个选型标准。第一是免费。这话听起来像废话但实际上不少方案宣传的时候说是免费用两天就发现免费额度只够尝鲜或者核心功能藏在付费档位里。我只接受从下载到日常使用都不用付费的方案。第二是 3 分钟内能跑通。OpenClaw 这种框架本身配置就不算简单如果再引入一个要配环境变量、下载模型、处理 CUDA 依赖的语音方案等于给自己挖坑。我要的是一条“改一行配置、写一个脚本”就能出声音的路径。第三是长期维护风险低。所谓风险低就是说这个方案不要太依赖某个服务商的政策变化也不要依赖某个社区项目会不会断更。系统内置语音引擎是操作系统自己的功能只要不重装系统它就在那里天然满足这个条件。这三条标准一卡我的选择其实已经很明确了。2. 为什么我最终选了“系统内置TTS”这个野路子2.1 四种方案摆一起看看对比数据有时候比看长篇评测更直观我把自己实际测下来的感觉整理成了下面这张表。对比维度云端语音合成本地大模型轻量开源库系统内置TTS音质听感最接近真人很接近真人中等偏机械首次安装成本注册 配置密钥下载模型 配环境装依赖 调参数零安装离线可用否是是是运行时资源占用低网络开销除外很高中低极低中文发音表现很好好参差系统自带语音包可用长期可靠性看服务商脸色看项目更新看社区维护系统不挂它就在我当时把这表发给一个朋友看他回了一句话“你这选项分析做得跟相亲似的。”但事实就是这样OpenClaw 要的是稳定输出不是选美。你要真让我在“云端方案偶尔抽风”和“系统方案永远在线”之间选我肯定选后者。2.2 系统TTS到底是怎么工作的很多人一听“系统内置语音引擎”就觉得是 Chrome 朗读网页那种简陋玩意儿其实它的底层是操作系统级的声音合成能力。Windows 上有一套完整的语音合成接口macOS 自带的语音引擎也可以直接读文本Linux 桌面发行版基本都有预装的命令行语音工具。这些引擎的工作流程大体上就是你把一段文本丢给它它内部通过语音合成引擎把文本拆成音素再根据内置的发音词典和韵律模型生成音频数据最后交给声卡播放。整个过程在本地完成不产生任何网络流量。听起来好像没什么技术含量但对 OpenClaw 这种场景来说技术含量恰恰不重要。它在乎的是你能不能稳定地叫它发出声音而不是它能不能念出一段带情绪的散文。一条系统命令一个文本参数输出直接落到扬声器上这就是最符合“代理”气质的语音方案。2.3 音质确实不行但我要的根本不是音质我承认第一耳朵听到系统 TTS 的声音时确实有一股“电子客服”那味儿。但仔细想一下OpenClaw 的主要语音场景是什么是结果播报、状态提醒、任务摘要不是给你唱摇篮曲。你要让代理帮你查个天气、跑个脚本、汇总一份报告回来的时候用语音把结论读给你听。这种信息密度很高的播报对音色的要求其实没那么苛刻。反而能听清楚、不吞字、不莫名卡顿才是真正的核心体验。而且系统 TTS 有一个云方案替代不了的优势播放是即时的。云端方案再快也要走一轮 HTTP 请求断网的时候直接没辙。本地模型再厉害也要跑一次推理。系统 TTS 基本是按下去就响跟 CPU 打一个字母出一个字符一样这种即时反馈在连续对话场景里太重要了。3. 三分钟落地实操让 OpenClaw 开口说话3.1 第一步写一个零依赖的语音脚本我这里用一个跨平台的 Python 脚本做示例它只调用系统自带的语音引擎不需要 pip 装任何包。写法也比较直白你把它保存成/opt/openclaw/scripts/speak.py就能用。import sys import subprocess import platform def speak(text): text text.strip() if not text: return system platform.system() if system Windows: # Windows 走 PowerShell 自带的语音合成对象 # 建议把下面的命令单独存成 speak.ps1 再调用避免每次转义麻烦 ps_script Add-Type -AssemblyName System.Speech; \ $s New-Object System.Speech.Synthesis.SpeechSynthesizer; \ $s.Speak($args[0]); subprocess.Popen([powershell, -NoProfile, -Command, ps_script, text]) elif system Darwin: # macOS 直接用 say 命令 subprocess.Popen([say, text]) else: # Linux 一般用 espeak-ng部分发行版可能需要先安装 subprocess.Popen([espeak-ng, -v, zh, text]) if __name__ __main__: if len(sys.argv) 1: speak(sys.argv[1])如果你用的是 Windows也可以更干脆一点把 PowerShell 脚本独立保存成speak.ps1# speak.ps1 Add-Type -AssemblyName System.Speech $s New-Object System.Speech.Synthesis.SpeechSynthesizer $s.Speak($args[0])然后调用powershell -NoProfile -ExecutionPolicy Bypass -File speak.ps1 你好。这样省掉了嵌套引号的烦恼调用也更稳定。Linux 上如果提示找不到espeak-ng用系统包管理器装一下就好。这也算是全过程中唯一可能需要主动安装的组件其他都是系统自带。3.2 第二步把语音脚本挂到 OpenClaw 输出钩子上OpenClaw 这类框架一般都会在关键节点暴露事件回调或者自定义命令的入口。有的版本支持在配置文件里直接挂外部命令有的版本需要你在包装脚本里手动调用。我用的方式是在配置文件里加一段自定义输出处理把所有最终回复统一转给语音脚本。下面是一个典型的配置示意具体的键名会随版本不同有差异但思路是一致的voice: enabled: true # 触发时机代理生成最终回复之后 event: reply.final # 把回复文本作为参数传给外部脚本 command: [python3, /opt/openclaw/scripts/speak.py] # 不阻塞主流程避免声音还没播完代理就等在那 async: true这里最关键的一个参数是async: true。它让语音播放在后台进行主线程继续处理后面的任务。不然就会出现一种很蠢的情况代理每说一句话整个流程都要等声音念完再继续长回复能卡死你几分钟。如果你的版本没有现成的event配置也不用慌。OpenClaw 的输出日志一般是可以拦截的你在入口处加一层薄薄的包装脚本读取代理返回的文本然后调用上面的speak.py效果完全一样。我自己最早就是从“监听输出流”这种方式起步的后来为了统一配置才换到事件钩子。3.3 第三步配置音色、语速、音量的正确姿势系统 TTS 默认的音色一般比较中庸但可以通过参数微调。Windows 的SpeechSynthesizer自带多个系统语音包你可以先列出来看看有哪些可用Add-Type -AssemblyName System.Speech $s New-Object System.Speech.Synthesis.SpeechSynthesizer $s.GetInstalledVoices() | ForEach-Object { $_.VoiceInfo.Name }macOS 的say支持用-v参数切换音色比如中文语音包一般是-v Tingting。Linux 的espeak-ng可以用-v zh选中文还能用-s调整语速、-a调整音量。我实际调下来语速比默认慢一点点听起来会更清楚。Windows 里Rate默认是 0范围从 -10 到 10设成 -1 或者 -2 会舒服很多。macOS 的say默认语速偏慢我反而会稍微调快一档。Linux 的espeak-ng默认语速偏快我通常用-s 150左右。这里给一个我调整过的参数版本照着用就行def speak(text): text text.strip() if not text: return system platform.system() if system Windows: ps_script Add-Type -AssemblyName System.Speech; \ $s New-Object System.Speech.Synthesis.SpeechSynthesizer; \ $s.Rate -1; \ $s.Volume 90; \ $s.Speak($args[0]); subprocess.Popen([powershell, -NoProfile, -Command, ps_script, text]) elif system Darwin: subprocess.Popen([say, -r, 200, text]) else: subprocess.Popen([espeak-ng, -v, zh, -s, 150, -a, 90, text])3.4 从“哑巴”到“开口说话”的完整验证流程配置改完验证是最重要的。我第一次配完以为成了结果发现 OpenClaw 的日志里确实调用了脚本但整个系统只有日志没有声音排查了半天才发现是执行用户没有访问音频设备的权限。我建议按下面的顺序测每一步都单独确认先用命令行直接测语音脚本本身比如python3 speak.py 你好这是测试声音。如果这一步没声音后面 OpenClaw 怎么调都不会有先解决系统层面的问题。然后测配置文件里的事件绑定。故意让 OpenClaw 执行一个简单的任务比如让它打印一句话看看终端里是否出现调用 speak.py 的记录。如果事件没触发多半是事件名或者命令路径写错了。最后测完整链路。跑一个稍微有实际内容的任务让它播报整个回复。这时候要重点观察任务结束前声音有没有播完有没有卡在后台以及多次播放有没有占满 CPU。整套流程走下来正常也就一杯茶的功夫。4. 常见问题与排查实录4.1 第一个问题永远是为什么没声音我把语音方案分享给几个朋友后收到的反馈里至少有七成都是“没声音”。而且大家的问题还真不太一样有的简单有的隐蔽我整理了一个排查顺序供参考。现象可能原因处理方式命令行直接跑就没声音系统音量静音、输出设备不对先调系统音量确认默认播放设备命令行有声音OpenClaw 调用后没声音脚本路径错误或事件没触发检查配置里的 command 路径手动执行一次确认调用后终端有报错但听不到声音当前用户没有音频设备权限把执行用户加入 audio 组或改用桌面会话运行声音断断续续播放与主线程互相抢占资源保持异步播放必要时增加播放队列服务器上有声音设备但实际无声卡系统没有物理输出口配置虚拟声卡或把音频转发到局域网设备如果你是在一台无头服务器上跑 OpenClaw没有插音箱也没有输出设备那它确实没法发出声音来。这个不算故障是物理条件限制解决思路可以看后面的第四节。4.2 中文吞字、读错字怎么救系统 TTS 在朗读中文的时候偶尔会出现吞字、读错多音字、或者把标点也念出来的问题。这些大多数时候不是 bug是语音包的发音词典不够全。Windows 上如果你发现中文读得很怪先检查当前选中的是不是中文语音包。有些系统默认选了一个英文语音包遇到中文字符会逐字硬拼听起来就非常折磨。切成Microsoft Huihui或者Microsoft Kangkang这类中文语音包就好了。macOS 上中文语音包的名字一般会带明显的拼音后缀比如Tingting。如果你听到的是满口英文腔读中文大概率是音色选错了。Linux 的 espeak-ng 对中文的支持比较看语音包质量。个别情况下会遇到声调不准、词语断句错乱我试过换用别的语音包之后明显改善。实在不行也可以给 OpenClaw 的输出加一层简单的文本预处理把容易读错的缩写、数字、英文单词替换成更口语化的中文表达。4.3 长文本卡住阻塞、爆音和超时OpenClaw 有时候一口气会输出一大段回复直接丢给语音引擎容易有两个后果。一个是播放时间太长把整个任务流程拖住另一个是文本里包含大量特殊字符语音引擎处理起来会莫名卡死。解决办法就是拆分。不要让语音引擎一次性处理整段长文本而是按句子切分成小块逐块播放。中文可以按句号、感叹号、问号切分英文按句点和换行切分。我写了一个小函数做这件事import re def speak_long(text): # 按中英文句子结束符分块 parts re.split(r(?[。!?]), text) for part in parts: if part.strip(): speak(part) # 给每一小段之间留一点自然停顿 import time time.sleep(0.15)这样既不会出现一句没说完就被掐断的情况也不会因为文本太长导致语音引擎内部缓冲溢出。比硬喂整段文本稳得多。4.4 服务器没声卡让它说给谁听很多人跑 OpenClaw 的地方不是自己的电脑而是云服务器或者家里的 NAS。这种环境往往没有声卡甚至整个系统就是无头模式。没有音频设备你让 TTS 播给谁听我的经验是两条路线。一条是给系统装一个虚拟声卡让语音输出到音频流里再通过网络串流到手机或者电脑上播放。比如 PulseAudio 提供空输出模块配合局域网音频转发工具就能把服务器上的声音传到你的桌面端。这个方案配置稍微绕一点但胜在稳定。另一条更简单既然服务器没有声卡那就别在服务器上发声把文本转成音频文件然后推送到你的设备上。很多即时通讯工具的 Webhook 接口或者自建的消息推送通道都能够接收文件这样 OpenClaw 生成一段语音文件后直接推送给你在手机上随时可以听。本质上还是那些免费消息通道不需要额外花钱。这两条路线我目前更推荐后者理由就一句话你对“消息送达”的掌控力更强。本地播放受网络和硬件影响的因素太多推送文件反而是一种从端到端的可靠路径。5. 会说话之后还能怎么玩5.1 给 OpenClaw 加上“耳朵”有了“嘴”很自然会想再给它配个“耳朵”。让 OpenClaw 听懂你说话本质上就是把语音转文字STT之后再送进它的对话入口。免费思路也有几条。最省事的是借助浏览器自带的语音识别接口你打开一个本地网页对着麦克风说话它把文字转出来之后通过本地接口扔给 OpenClaw。这种方案无需额外装模型适合轻量交互场景。如果你想要离线而且更可控可以在本地跑一个开源语音识别模型把麦克风采集到的音频实时转写。这个方案的资源占用比系统 TTS 高不少但对于已经跑 OpenClaw 的机器来说只要不是太老配置通常能接受。给 OpenClaw 加上输入通道之后它的使用场景就从“单向播报代理”变成了“双手解放的语音助手”。我在本地就是这么干的问一句“现在几点了”它转成文字后自己去查再用语音念结果回来闭环体验非常顺手。5.2 多角色切换系统 TTS 虽然音色选择有限但也不是只有一种。Windows 和 macOS 都内置了不止一个语音包可以按场景切换使用。我给 OpenClaw 配了两套音色日常任务播报用一个普通中文音色任务出错或者需要强调的紧急提醒用另一个明显不同的音色。这样你不用看屏幕光靠声音就能判断代理汇报的是好消息还是坏消息。多音色还有一个隐藏好处就是当你同时跑多个代理实例的时候每个实例用不同音色区分不会混在一起听不出是谁在说话。配置上其实很简单在语音脚本里增加一个参数OpenClaw 调用时根据事件类型传进来不同的音色标识。比如python3 speak.py 备份任务已完成 --voice default python3 speak.py 备份任务失败请检查磁盘 --voice alert5.3 定时播报与任务通知OpenClaw 本身就有很强的任务调度能力配上语音之后很多“定时”玩法就顺理成章了。比如每天早上定时跑一个信息汇总任务然后把结果用语音播报出来或者每天晚上定时检查磁盘空间、备份状态有异常才开口正常就保持沉默。这种玩法对资源配置非常友好因为语音本身只在关键时刻才触发平时就是零成本待机。你别看它简单实际用起来特别提升体验——代理不再是屏幕上一个冷冰冰的进程而是会主动跟你打招呼、会提醒你该干嘛的生活管家。我后来还在语音脚本里加了缓存处理对同一个任务在短时间内的重复播报直接跳过避免代理因为循环任务反复念同一句话。这个优化思路可以扩展一下任何重复性、模板化的播报都值得做一层去重不然连续被同一个声音轰炸几次之后再新鲜的功能也会让人烦躁。玩到这里OpenClaw 已经从“能干活但没声”变成了“既能干活又会说话”关键是整条链路没有花一分钱也没有引入任何随时可能失效的外部依赖。如果你手头也有一台跑着 OpenClaw 的机器不妨照着上面的步骤试一次大概率会比你想的更顺利。
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
