OpenClaw本地离线Whisper完整配置指南
很多朋友问OpenClaw的语音识别怎么配置。今天分享一套纯本地离线方案，不联网、不上传音频、保护隐私，适合macOS用户。
一、安装依赖
1. 安装ffmpeg
brew install ffmpeg
2. 安装Whisper依赖库
pip install openai-whisper
若多Python版本，建议用pip3；虚拟环境请先进入对应环境。
二、下载本地模型（仅首次需联网）
中文优先选medium，兼顾速度与准确率：
# 推荐（均衡）
whisper download medium
# 低配机器/追求速度
whisper download small
# 高精度（体积大、慢）
whisper download large-v3
模型默认存放路径：~/.cache/whisper
三、修改OpenClaw配置文件
1. 打开配置文件
code ~/.openclaw/openclaw.json
# 无code命令用：open ~/.openclaw/openclaw.json
2. 写入配置（无需API Key）
{
"voice": {
"stt": {
"provider": "whisper-local",
"model": "medium",
"language": "zh"
}
}
}
注意：
- model值和下载的模型名保持一致
- 纯离线，全程不联网、不上传音频
四、重启服务生效
openclaw gateway restart
五、测试与日志查看
1. 测试识别
访问页面：http://localhost:7799，点击麦克风说话测试
2. 查看识别日志排查问题
tail -f ~/.openclaw/logs/gateway.log | grep stt
六、macOS常见问题处理
1. pip命令找不到
python3 -m pip install openai-whisper
2. 麦克风无权限
系统设置 → 隐私与安全性 → 麦克风，给终端/浏览器开启权限。
3. M系列芯片加速
macOS原生支持Metal加速，无需额外配置，Whisper会自动调用GPU提速。
4. 轻量化方案（更低资源占用）
clawhub install whisper-cpp
安装后把配置里provider改为whisper-cpp即可。
方案对比
| 方案 | 资源占用 | 速度 | 隐私 |
|---|---|---|---|
| whisper-local (medium) | 中等 | 中等 | 满分 |
| whisper-cpp | 低 | 快 | 满分 |
| 云端API | 低 | 快 | 一般 |
总结
这套方案的优势：
- 纯离线：音频数据永不离开本地
- 无需API Key：零成本
- 隐私保护：敏感场景也可用
- Metal加速：M芯片Mac自动提速
适合对隐私有要求、不想付费的用户。配置一次，长期使用 🚀
转载请注明来源，欢迎对文章中的引用来源进行考证，欢迎指出任何有错误或不够清晰的表达。可以在下面评论区评论，也可以邮件至 1056615746@qq.com
