OpenWhispr 使用教程

按快捷键说话,字直接进Codex

⭐ 完全开源 · MIT

📖 项目简介

OpenWhispr 是一个桌面语音输入工具,仓库名 OpenWhispr/openwhispr。截至 2026-09-23,GitHub 上约 8,466 Star,协议是 MIT。按一下全局快捷键说话,文字出现在当前光标位置,并可以自动粘贴进任意输入框。macOS、Windows、Linux 都有安装包,Windows 直接下 .exe。

本地转写可选 Whisper、NVIDIA Parakeet、Orukeet、Cohere Transcribe。选本地模型时,音频不离开这台电脑,仓库说明里写了不做数据采集、不上报遥测。也可以改用云端模型换速度。技术栈是 Electron 41、whisper.cpp、sherpa-onnx。本地 Whisper 可走 Metal、CUDA 或 Vulkan 加速。

和 Codex 配合时,它不是一条要安装的 Skill。把光标放进 Codex 输入框,按快捷键把需求说完,字就进输入框。另有语音助手快捷键:先选中一段文字,再说怎么改,它会把这段话交给你配置的模型原地修改。会议转写、拖入音视频转文字也在同一个软件里。

✨ 核心亮点

🎙️
光标在哪,字就进哪
全局快捷键说话,文字自动粘贴到 Codex、浏览器、聊天框等任意输入位置。
🔒
本地模型不出电脑
Whisper、Parakeet 等可在本机转写。选本地模式时,音频不上传。
📋
会议自动成纪要
识别 Zoom、Teams、FaceTime 通话,区分说话人,并整理成笔记。
✏️
选中文字,动嘴就改
语音助手快捷键把你说的话交给已配置的模型,原地改选中内容。

🧩 它能做什么、输出什么

项目说明
输入麦克风实时说话;也可拖入已有音视频,或粘贴音视频链接做批量转写
适用类型给 Codex 口述需求、会议记录、选中文字后口述修改、把录音转成文字
输出光标处的文字(可自动粘贴);会议笔记;转写文本。笔记可按文件夹整理
语言 / 兼容中英混说优先选 Whisper。macOS、Windows、Linux。另有语音翻译快捷键:一种语言说、另一种语言贴
规格 / 容量本地模型音频留在本机。仓库未给出统一的时长上限;批量转写以你下载的模型大小和本机内存为准

🖥️ 环境要求

环境建议配置
操作系统Windows 下安装包;macOS 分 Apple 芯片和 Intel;Linux 提供 AppImage、deb、rpm、tar.gz
运行环境日常使用:下载安装包即可,不用装 Node。从源码跑:Node.js 24 或更新,在仓库根目录执行安装命令
硬件本地 Whisper 可用 Metal、CUDA、Vulkan(含 AMD / Intel)加速。仓库没有公布统一显存数字,模型越大越吃内存
低配 / 无卡方案没有独显就改用云端转写(自备模型密钥),或选更小的本地模型。Intel 版 Mac 仍可录音转写,实时说话人识别不可用
关键依赖安装包已带界面。本地转写依赖 whisper.cpp(Whisper)和 sherpa-onnx(Parakeet)。麦克风权限必须打开

🚀 如何使用

💡
最省事的路径:去发布页下 Windows 安装包,装好选 Whisper,设一个快捷键,把光标放进 Codex 再说一句。
1

准备环境

用安装包的话,只要 Windows 能装桌面软件,并允许麦克风。从源码跑才需要 Node.js 24 或更新。先在终端确认版本:

bash node -v
2

下载安装包

在 GitHub 搜索 OpenWhispr/openwhispr,进入 Releases 页面。Windows 下载 .exe 双击安装。Mac 下对应芯片的 .dmg,Linux 按发行版选 AppImage、deb 或 rpm。地址在文末折叠链接里。

text Releases 页面 → Windows .exe → 安装 → 允许麦克风
3

选模型并设快捷键

第一次打开会让你选语音模型。中文和英文一起说,选本地 Whisper。只想速度快、能接受声音出电脑,再改云端。然后设两个键:一个是听写(字进光标),一个是语音助手(改选中的文字)。

text 模型选 Whisper → 打开本地模式 → 记下听写快捷键 → 打开自动粘贴

常用选项:

选项作用
本地 Whisper中英都能说,音频留在本机。这是本教程的默认选择
NVIDIA Parakeet仓库列为更快的多语言本地模型。中文准不准以你这台电脑试听为准,教程不替它打包票
云端模型换速度,需要自己的密钥。声音会离开电脑
自动粘贴转写完成后把文字贴到当前光标。给 Codex 提需求时要开着
听写翻译快捷键用一种语言说,贴出另一种语言的文字
4

会议、改字、导入音频

开会时它会识别 Zoom、Teams、FaceTime,并区分说话人。改已有文字:先选中,再按语音助手快捷键说出要怎么改。已有录音:拖进窗口,或一次放多个文件。Intel 版 Mac 可以转写,实时说话人识别不可用,笔记搜索会退回关键词匹配。

text 选中文字 → 语音助手快捷键 → 说出修改 → 原地替换 拖入音视频 → 转成文字(可选区分说话人)
5

结合 Codex 使用

打开 Codex,点进输入框。按听写快捷键,把需求说完:改哪个文件、要什么效果、哪里不能动。松键后文字进输入框,你再看一眼,回车发送。要改 Codex 已经写出来的一段说明,先选中那段,用语音助手快捷键口述修改。仓库另有 MCP,管的是它自己的笔记和转写,不是替你操作 Codex。

✅
光标停在 Codex 输入框里说话,需求不用再手打。说完自己看一遍再发送。
6

想改代码时再从源码跑

日常使用到上一步就够了。只有要改 OpenWhispr 本身时,才把仓库克隆到本地(地址在文末折叠链接),然后:

bash cd openwhispr npm install npm run dev

🎯 典型应用场景

⌨️
给 Codex 口述需求
光标放进输入框,把改哪个文件、要什么效果一次说完。
📋
开会出纪要
Zoom、Teams、FaceTime 通话转成带说话人的笔记。
✏️
改已经写好的一段
选中文字,用语音助手快捷键说怎么改。
🎧
录音转文字
把音视频拖进去,或一次放多个文件。
🌐
边说边翻译
听写翻译快捷键:一种语言说,贴出另一种语言。
🔒
不想上传声音
选本地 Whisper,转写留在这台电脑上。

📈 和同类比、原理是什么

对照说明
官方定位仓库自称是 Wispr Flow、Granola 的开源替代,协议 MIT
官网演示语速演示画面写打字约每分钟 40 个词,用它说话约 150 个词。这是官网演示数字,不是本账号实测
本地转写Whisper 走 whisper.cpp,Parakeet 走 sherpa-onnx。音频在本地模式不离开设备
Star2026-09-23 查看仓库约 8,466 Star
🧠
它快在「说话代替打字」:快捷键采集音频,本地或云端模型转成文字,再粘贴到光标。不是把 Codex 本身换成语音模型。

❓ 常见问题

Q: 和 Wispr Flow 有什么区别?

仓库把自己定位成 Wispr Flow、Granola 的开源替代。代码是 MIT,可以自己看、自己改。功能是否一一对应,以你装上后的界面为准,不要按闭源产品的功能表硬套。

Q: 支持哪些系统和输入?

macOS、Windows、Linux 都有安装包。输入是麦克风,也可以拖入已有音视频。听写结果贴到当前光标,不限 Codex。

Q: 快捷键按了没反应?

先看麦克风权限有没有开,再看快捷键是不是和别的软件撞了。Windows 上如果被输入法或录屏软件占用,换一个组合键。仍不行,打开文末折叠里的排错文档。

Q: 没有独显、内存不大怎么办?

本地大模型会吃内存。可以改小一号的 Whisper,或改用云端转写(需要自己的密钥,声音会离开电脑)。仓库没有公布「至少多少显存」。

Q: 中文该选哪个模型?

中文和英文一起说,选本地 Whisper。Parakeet 在仓库里是更快的多语言模型,中文效果这篇教程没有实测,装好后用同一句话自己听一遍再决定。

Q: 怎么和 Codex 一起用?

不用给 Codex 装插件。光标点进 Codex 输入框,按听写快捷键把需求说完,确认文字后再发送。要改一段已有文字,先选中,再用语音助手快捷键。

Q: 它和 OpenAI Whisper 是什么关系?

Whisper 是语音识别模型。OpenWhispr 用 whisper.cpp 在本地跑它,外面包了一层快捷键、粘贴、会议和笔记。装的是 OpenWhispr,不是单独去配 Whisper 命令行。

Q: 可以商用吗?

仓库许可证是 MIT,个人使用和商用都可以。云端模型、日历、团队空间如果走到第三方服务,还要另外看那些服务自己的条款。Intel 版 Mac 没有实时说话人识别,会议转写本身可用。