KONWA Setup SKILLS

---
name: konwa-setup
description: 安装、设置 KONWA 并排查故障。KONWA 是实时语音翻译桌面应用（macOS / Windows），把用户说的话翻译后，通过虚拟麦克风送进 Zoom、Teams、Discord、腾讯会议、OBS 等软件。用户要安装 KONWA、把它接进某个通话或直播软件，或者遇到“对方听不到 / 听到原声 / 有回声 / 自己听不到”时使用。
---

# KONWA 安装与排障

KONWA 把用户说的话实时翻译成另一种语言，用合成语音朗读，再通过虚拟麦克风送进其他软件，对方听到的是译文。它也能把对方说的话翻成字幕（听译）。

## 先读：这些事只能交给用户

到下面这些步骤时，告诉用户要做什么、在哪里做，等用户说做完了再继续。不要代填密码或验证码，也不要尝试绕过：

- 输入电脑密码或管理员密码（macOS 授权虚拟麦克风时）
- Windows 的“允许此应用对你的设备进行更改”和“安装此设备软件”
- 网页登录：邮箱验证码、人机验证、Google 账号
- 系统权限弹窗：麦克风、录屏与系统录音、辅助功能
- 重启电脑

## 链路

译文要经过四段才能到对方，缺一段都不行：

1. 实体麦克风 → KONWA（「设置 → 设备 → 你说话」）
2. KONWA → 虚拟麦克风（「设置 → 设备 → 对方听到」；macOS 是 KONWA Microphone，Windows 是 VB-CABLE）
3. 虚拟麦克风 → 目标软件的麦克风
4. 目标软件 → 对方

另有一条独立的路：目标软件和系统的声音 → 用户的耳机。必须用耳机：外放时，麦克风会录进对方的声音和译音，KONWA 会把它们当成用户的话再翻一遍。

出了问题，先判断断在哪一段，再修那一段。

## 先查清楚

能用命令查到的，直接查，不要问用户。

macOS：

- 系统版本：`sw_vers -productVersion`（需要 14 及以上；听译需要 14.2 及以上）
- 芯片：`sysctl -in hw.optional.arm64`（输出 `1` 才是 Apple 芯片；Intel Mac 不支持。不要用 `uname -m`，终端在 Rosetta 下运行时它会报 x86_64）
- KONWA 是否已装、什么版本：`defaults read /Applications/KONWA.app/Contents/Info CFBundleShortVersionString`
- 虚拟麦克风是否已装：`ls "/Library/Audio/Plug-Ins/HAL/" | grep -i konwa`（应有 `KONWA Microphone.driver`）
- 音频设备和默认输入：`system_profiler SPAudioDataType`
- 装了哪些通话或直播软件：`ls /Applications`

Windows（PowerShell）：

- 系统版本：`[Environment]::OSVersion.Version`（Windows 10 / 11 64 位；Build 22000 及以上是 Windows 11；听译需要 Build 19041 及以上，即 Windows 10 版本 2004）
- KONWA 是否已装、什么版本：
  `Get-ItemProperty HKCU:\Software\Microsoft\Windows\CurrentVersion\Uninstall\*, HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\*, HKLM:\Software\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\* -ErrorAction SilentlyContinue | Where-Object DisplayName -like 'KONWA*' | Select-Object DisplayName, DisplayVersion`
- VB-CABLE 是否已装：`Test-Path HKLM:\SYSTEM\CurrentControlSet\Services\VBAudioVACMME`（KONWA 自己也用这一项判断）
- 虚拟设备是否正常：`Get-PnpDevice -Class AudioEndpoint -PresentOnly | Where-Object FriendlyName -like '*CABLE*' | Select-Object FriendlyName, Status`（应有 CABLE Input 和 CABLE Output，可能还有一个 CABLE In 16ch，状态都是 OK）
- 默认播放设备：命令查不到。运行 `mmsys.cpl`，请用户看「播放」页的默认设备，它不能是 CABLE Input。
- 正在运行的软件：`Get-Process | Select-Object -Unique ProcessName`

## 安装与设置

按顺序做，每一步达到“完成”再往下。

### 1. 安装

从 https://konwa.live/download 下载对应系统的安装包。

- macOS：打开 dmg，把 KONWA 拖进「应用程序」。
- Windows：运行安装程序。出现“Windows 已保护你的电脑”时，点「更多信息」→「仍要运行」（KONWA 的安装包还没有代码签名）。安装程序会自动装好 KONWA 必需的虚拟麦克风 VB-CABLE（已经装过的不再装），没有需要勾选的选项。接下来的系统授权，以及 Windows 可能弹出的“安装设备软件”提示，交给用户点允许。安装程序不要求重启，装完会直接打开 KONWA。

不要另外去下载 VB-CABLE 或 BlackHole：KONWA 自带所需的虚拟麦克风。

完成：KONWA 能打开。

### 2. 登录（交给用户）

在 KONWA 点「在浏览器中登录」。用户在打开的网页里用邮箱验证码或 Google 账号登录；浏览器问是否打开 KONWA 时，选允许。

如果没有自动回到 KONWA：在 KONWA 点「手动输入代码」，填登录完成页上显示的 8 位代码（不是邮件里的 6 位验证码）。

完成：KONWA 不再显示登录页。

### 3. 首次引导

登录后，KONWA 会带用户走一遍：选语言、允许使用麦克风、说一句话试试。试说的声音从用户自己的耳机或扬声器播放，不需要虚拟麦克风。

- 先问清楚：用户说什么语言，对方要听什么语言。
- 系统请求麦克风权限时，交给用户点允许。之前拒绝过的：macOS 在「系统设置 → 隐私与安全性 → 麦克风」里打开 KONWA；Windows 在「设置 → 隐私和安全性 → 麦克风」里打开（Windows 10 是「设置 → 隐私 → 麦克风」）。

完成：用户说话时，KONWA 显示出原文和译文。

### 4. 虚拟麦克风（第 2 段）

- macOS：首次引导结束后，KONWA 会提出添加 KONWA Microphone。用户点「授权」，输入这台 Mac 的密码（需要管理员账号）。当时点了「稍后」的，在「设置 → 设备」里点「授权」。
- Windows：首次引导结束后，KONWA 会检查安装程序装好的 VB-CABLE。已经可用时，直接进入首页，并提示一次「在语音软件里，把麦克风选成 CABLE Output」。否则只显示一页：「重启」（只在 KONWA 说需要重启时出现，交给用户重启）或「授权」（用户允许 Windows 的权限提示；Windows 问到时，允许“安装设备软件”）。当时点了「稍后」的，首页和「设置 → 设备」里有同一个按钮。

然后打开「设置 → 设备」，读出「对方听到」显示的设备名：macOS 是 KONWA Microphone，Windows 是 CABLE Output (VB-Audio Virtual Cable)。后面要用它的确切文字。

完成：拿到了设备名，而且这一栏没有「授权」或「重启」。

### 5. KONWA 的输入（第 1 段）

在「设置 → 设备 → 你说话」里选用户的实体麦克风；如果系统默认输入就是实体麦克风，保持「跟随系统默认」也可以。

完成：「你说话」是实体麦克风，不是虚拟麦克风。

### 6. 目标软件（第 3 段）

查看已安装或正在运行的软件，列出候选，请用户选一个。在这个软件里把麦克风设成第 4 步拿到的设备名，输出保持耳机。

- Zoom：设置 → 音频 → 麦克风；同时关闭「自动调整麦克风音量」
- Microsoft Teams：设置和更多（…）→ 设置 → 设备 → 音频设置 → 麦克风
- Google Meet：更多选项 → 设置 → 音频 → 麦克风
- Discord：User Settings → Voice & Video →「Voice」分页 → Input Device
- 腾讯会议：会前在主界面左下角「设置」→「音频」；会中在右上角「设置」→「音频」。同时关闭「自动调整麦克风音量」
- OBS Studio：添加「音频输入采集」来源，设备选虚拟麦克风；把实体麦克风的来源静音或删掉。不要再在「设置 → 音频 → 麦克风/辅助音频」里选同一个设备，会有回声。
- TikTok LIVE Studio（Windows 和 Mac）：控制栏「音频混音器」→「麦克风」→「添加」→「麦克风设备」选虚拟麦克风 →「添加」
- Steam：Steam 设置 → 语音 → 语音输入设备
- 其他软件：在它的音频或语音设置里找“麦克风”或“输入设备”。

完成：这个软件的麦克风是虚拟麦克风，输出是耳机。

### 7. 语言

KONWA 首页底部的控制栏里，第一个语言是用户说的，第二个是对方听到的。按第 3 步问到的设好。

完成：两个语言都对。

### 8. 验证

1. 在「设置 → 设备」点「试听」，确认 KONWA 能把声音送进虚拟麦克风（第 2 段）。
2. 在 KONWA 首页点「开始翻译」，让用户说一句话。
3. 用目标软件自带的测试，或者请对方帮忙，确认对方听到的是译文，不是原声。例如 Zoom 音频设置里的麦克风测试（英文界面叫 Test microphone）、Teams 的「进行测试呼叫」、腾讯会议的「检测麦克风」、Discord 的 Mic Test。

完成：对方听到的是译文。

### 9. 可选：听译（把对方的话翻成字幕）

需要 macOS 14.2 及以上，或 Windows 10 版本 2004 及以上。在首页的「听译」里选对方声音所在的软件。

macOS 会询问是否允许 KONWA 录制系统音频，交给用户点允许。之前拒绝过的，在「系统设置 → 隐私与安全性 → 录屏与系统录音」里打开 KONWA，再重新选一次软件。Windows 不需要权限。

完成：对方说话时，KONWA 显示出对方的字幕。

## 故障定位

| 症状 | 断在哪 | 怎么修 |
| --- | --- | --- |
| 对方听不到 | 第 3 段没接，或 KONWA 没在翻译 | 目标软件的麦克风改成虚拟麦克风；在 KONWA 点「开始翻译」 |
| 对方听到原声 | 第 3 段还是实体麦克风 | 目标软件的麦克风改成虚拟麦克风 |
| 对方听到两遍或有回声 | Windows 上目标软件的输出被设成了 CABLE Input | 输出改回耳机 |
| 对方听到的音量忽大忽小 | 目标软件在自动调整麦克风音量 | 关掉这个选项 |
| 用户自己完全听不到声音 | Windows 的系统输出被设成了 CABLE Input | 在「设置 → 设备 → 你听到」或 Windows 声音设置里改回耳机（KONWA 启动和开始翻译时也会把它换回真实扬声器） |
| KONWA 收不到用户说话 | 第 1 段 | 检查「你说话」和系统的麦克风权限 |
| 提示麦克风被其他程序占用 | 第 1 段 | 关掉占用麦克风的程序 |
| 对方的话出现在用户自己的字幕里 | 用户在外放 | 换耳机 |
| 首页或「设置 → 设备」显示「虚拟麦克风还不能用」 | 第 2 段没装好、被删除或损坏 | 点「授权」，它也是重试和修复；之后 KONWA 要求重启时才重启 |
| 显示「重启电脑后，虚拟麦克风就能用了」 | 虚拟麦克风刚装好 | 点「重启」（交给用户） |
| 测试时提示「没有传回声音」 | 虚拟设备异常 | 重启电脑 |
| 提示「音频组件没加载」 | KONWA 安装不完整 | 重新安装 KONWA |
| Mac 上目标软件还在用 BlackHole 2ch | 旧版 KONWA 遗留 | 改成 KONWA Microphone（BlackHole 可留可卸） |
| 选了「按住说话」但按键没反应（macOS） | 没有辅助功能权限 | 交给用户：「系统设置 → 隐私与安全性 → 辅助功能」里打开 KONWA |
| 提示「时长已用完」 | 账户的时长用完了 | 交给用户处理 |

## 不要做

- 不要把虚拟麦克风选成 KONWA 的输入（「你说话」）。
- Windows 上不要把 CABLE Input 设成系统或目标软件的输出。
- 不要另装 BlackHole、VB-CABLE 或其他虚拟声卡。
- 不要替用户输入密码或验证码，也不要绕过人机验证或系统授权。