故障排查
遇到问题时，先看看下面有没有你的情况。想了解 Owlfy 是什么、收不收费、要不要联网这类问题，请看常见问题。解决不了的话，可以在「设置 → 关于 → 帮助与支持」联系我们，附上 Owlfy 版本号、操作系统、操作步骤和错误提示，会更快解决。
按语音键没有反应
Section titled “按语音键没有反应”- 在「设置 → 通用」确认按键设置，看看是否和其他软件的快捷键冲突。
- macOS：在「设置 → 通用 → 系统权限」确认辅助功能权限已开启。刚授权的话，重启一下 Owlfy。
想打字却执行了指令（或者反过来）
Section titled “想打字却执行了指令（或者反过来）”两个键分工不同：语音输入键负责打字，语音执行键负责做事。鼠标滚轮默认是语音执行键，可以在「设置 → 通用」里改成语音输入或关闭。
没声音，或者识别不准
Section titled “没声音，或者识别不准”- 在「设置 → 语音」选对麦克风，点测试听一下。
- 确认系统已允许 Owlfy 使用麦克风。
- 「主语言」设成你实际说的语言。
- 常被认错的人名、术语，加到「语音输入 → 字典管理」里。
- 实时听写录电脑声音时，确认选了「系统声音」，并且电脑确实在播放声音。
文字没有打进去
Section titled “文字没有打进去”- 先点一下目标输入框，确认光标在里面。
- 检查辅助功能权限。
- 文字没丢，打开语音输入窗口的「语音输入历史」，点一下就能重新粘贴。
AI 没读到我选中的文字或文件
Section titled “AI 没读到我选中的文字或文件”先选中再发起任务。还是读不到的话，直接把文字粘贴到 AI 智能体，或者把文件拖进去。
浏览器连不上
Section titled “浏览器连不上”在「连接 → 浏览器」看看浏览器是不是显示「未安装」；已安装的话点「连接」，等状态变成「已连接」。如果没有检测到浏览器，先安装一款支持的浏览器再刷新。
本地模型连不上
Section titled “本地模型连不上”- 确认 Ollama 或 LM Studio 正在运行；
- 检查接口地址和端口；
- 确认模型名称一致；
- 添加成功后，记得在 AI 智能体的模型选择里切换过去。
能聊天但不会操作文件？换一个支持工具调用的模型。详见接入本地模型。
本地语音识别一直在准备
Section titled “本地语音识别一直在准备”到「设置 → 隐私」查看下载进度。检查网络和磁盘空间是否充足，失败时点「重试」。准备完成之前，语音识别还不会切换到本地。
技能装好了却用不了
Section titled “技能装好了却用不了”看看提示里缺什么：是需要登录第三方账号、网络连接，还是体力不足。按提示补上即可。
定时任务没有按时执行
Section titled “定时任务没有按时执行”- 在定时任务面板确认任务已启用，时间和执行方式正确。
- 到点时电脑必须开着、没有休眠，Owlfy 在运行。
- 需要上网的任务，检查网络是否正常。
手机发消息没回复
Section titled “手机发消息没回复”- 在「连接 → 手机远控」确认绑定状态正常；微信连接失效就重新扫码。
- 确认电脑开机、Owlfy 在运行、网络正常。
- 看看电脑上是不是有任务在等你确认，或者上一个任务还没完成。
点击导航栏底部的会员卡片查看体力，可以升级会员、完成任务或使用兑换码补充。详见体力。
Linux 用户
Section titled “Linux 用户”Owlfy 在 Linux 上主要适配 X11 桌面。如果你用的是 Wayland，全局快捷键、截图、读取选中文字和自动粘贴可能不太稳定，可以尝试切换到 X11 会话。