OpenWhispr 语音听写上手指南：安装、本地离线转写与会议转录设置

【免费下载链接】openwhisprVoice-to-text dictation app with local (Nvidia Parakeet/Whisper) and cloud models (BYOK). Privacy-first and available cross-platform.项目地址: https://gitcode.com/GitHub_Trending/op/openwhispr

在邮件或 IM 里打一段话，不如直接说出来。OpenWhispr 是一个开源免费的跨平台桌面语音听写应用：按下热键说话，文字自动出现在光标处，支持本地离线模型，音频可以不离开你的设备。

项目速览：OpenWhispr 是什么

OpenWhispr 定位是 WisprFlow、Granola 的开源替代，覆盖 macOS、Windows、Linux。

它把声音变成三种东西：听写文本、AI 指令结果、会议和笔记记录。

听写走全局热键，支持任意应用自动粘贴；AI 助手可选 GPT-5、Claude、Gemini 或本地模型；会议转录支持 Zoom、Teams、FaceTime 的说话人区分。

本地模式用 whisper.cpp 和 NVIDIA Parakeet 等模型离线转写，不做数据收集；云端模式（BYOK）适合需要速度的场景。核心功能本地、云端两种模式都能跑。

第一次跑通：从安装到完成首次听写

1. 获取安装包。从 Releases 页下载对应平台版本：macOS 是.dmg，Windows 是.exe，Linux 可选.AppImage、.deb、.rpm、.tar.gz。你看到的就是一个普通桌面应用安装包。

2. 首次启动。安装后启动，应用会引导你完成麦克风权限授权，并按 LOCAL_WHISPER_SETUP.md 里的流程进入设置引导。macOS 会在系统设置里请求麦克风权限；Windows 在设置 → 隐私 → 麦克风中确认开关。

3. 完成第一次听写。向导会让你确认听写热键（默认 F8，macOS 引导默认是右 Option 键）。把光标放进任意输入框，按住热键说话再松开。你会看到文字自动粘贴到光标位置——到这里，核心链路已经通了。

从源码运行的话（需 Node.js 24+）：

git clone https://gitcode.com/GitHub_Trending/op/openwhispr cd openwhispr && npm install npm run dev

核心功能拆解

语音听写：热键说话，光标处出字

适合任何需要大量输入的场景：邮件、IM、文档。

操作：按听写热键 → 说话 → 松开。文字自动粘贴到聚焦的输入框。另有专用热键可以做"说中文、粘英文"的翻译听写。

注意：听写质量取决于麦克风权限和输入设备选择，先确认系统声音设置里选对了设备。

AI 语音助手：免唤醒词下指令

适合让 AI 帮你改文案、草拟内容。

操作：按 Voice Assistant 热键直接说话，你说的话作为指令发给所选模型，高亮选中的文字会被就地编辑；开启自动粘贴后，结果会贴到光标处或流式显示在浮动面板。

注意：助手跑在"Chat"作用域的模型上，先在 设置 → AI Models → Chat 确认模型和 API key 配对了。

会议转录：自动检测通话，区分说话人

适合 Zoom、Teams、FaceTime 通话记录。

操作：提前在 Integrations 里连好 Google/Microsoft/Apple 日历，保持会议应用运行，OpenWhispr 检测到通话后弹出提示，点一下即可开始录制。

效果：实时说话人区分 + 设备端声纹指纹识别，转写存入笔记。macOS 需要授予屏幕录制权限。

笔记：转录结果的落点

听写和会议内容都进笔记，支持文件夹管理、语义搜索（本地嵌入模型）和 AI 操作。

进阶设置：本地 Whisper 模型选择

想彻底离线，只需一个配置：打开设置 → Speech to Text Processing，启用Use Local Whisper，选模型，保存。首次转写会自动下载模型到~/.cache/openwhispr/whisper-models/。

GPU 加速开箱即用：macOS 走 Metal，NVIDIA 走 CUDA，AMD/Intel 走 Vulkan；GPU 启动失败会自动回退 CPU，听写不中断。

常见问题速查

麦克风无反应 / "Permission denied"→ 系统级权限未授予。macOS 查 系统设置 → 隐私与安全性 → 麦克风；Windows 查 设置 → 隐私 → 麦克风；Linux 用pavucontrol确认输入设备。

历史记录里只有"you"或空条目→ 输入设备选错或热键误触发。先核对声音设置里的输入设备，再试换热键；仍不行清缓存rm -rf ~/.cache/whisper后重跑引导。

本地转写报 "whisper.cpp not found"→ 源码运行时未下载二进制。执行npm run download:whisper-cpp把二进制放进resources/bin/；或清模型缓存rm -rf ~/.cache/openwhispr/whisper-models后改用云端模式。

Windows 粘贴后目标应用提示剪贴板为空（Wayland 同理）→ 剪贴板后端不匹配。Linux 装wl-clipboard后重启应用即可。

下一步

OpenWhispr 用一条热键把"说话"变成"出字"，本地离线模式保证音频不出设备。从听写开始跑通，再按需接入会议转录和本地 Whisper；更多细节见 TROUBLESHOOTING.md 和仓库文档。

【免费下载链接】openwhisprVoice-to-text dictation app with local (Nvidia Parakeet/Whisper) and cloud models (BYOK). Privacy-first and available cross-platform.项目地址: https://gitcode.com/GitHub_Trending/op/openwhispr