准备工作:获取 ElevenLabs API 密钥
OpenClaw 的 TTS 功能依赖 ElevenLabs 的语音合成服务。ElevenLabs 提供免费账户,每月赠送 10,000 积分,用于调用文本转语音 API。对于个人用户的日常使用场景,这个额度基本够用。
注册完成后,进入开发者后台的 API Keys 页面,点击「创建密钥」。这里有一个细节需要注意:密钥只会显示一次,务必在创建后立即复制并妥善保存。
配置 OpenClaw
打开 OpenClaw 的设置文件,路径一般是:
~/.openclaw/openclaw.json
找到 messages 配置段,将 ElevenLabs 的 API 密钥和相关 TTS 参数填入。具体的配置字段可参考 OpenClaw 官方文档的 TTS 章节。
保存配置后,执行以下命令重启网关使配置生效:
openclaw gateway restart
效果验证
重启完成后,用语音消息与 OpenClaw 交互,它会以语音形式回复你。这意味着你可以构建一个完整的语音对话链路:语音输入 → 理解处理 → 语音输出。
整个过程不需要写一行代码,纯粹是配置层面的操作。当然,官方文档也提到可以把配置说明直接丢给 OpenClaw 让它自行修改,但实测下来自动修改容易报错,手动按步骤配置反而更稳妥。对于想要搭建语音交互 Agent 的独立开发者来说,十分钟完成配置,换来的是一个能「开口说话」的 AI 助手——投入产出比相当高。