ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

qwen-audio-agent 桌面应用完整入门指南:5 分钟拥有悬浮语音 Orb 助手

qwen-audio-agent 桌面应用完整入门指南:5 分钟拥有悬浮语音 Orb 助手 qwen-audio-agent 桌面应用完整入门指南5 分钟拥有悬浮语音 Orb 助手【免费下载链接】qwen-audio-agentA realtime voice runtime that keeps Agents talking, working, and present. Real-time Voice Runtime for AI Agents项目地址: https://gitcode.com/gh_mirrors/qw/qwen-audio-agentqwen-audio-agent 是一个实时语音运行时Real-time Voice Runtime它的桌面应用开箱即带一个可悬浮在屏幕上的语音 Orb 助手内置 Gateway无需在终端启动任何服务装好、填一个 API Key就能直接开口对话还能把搜索、写代码等重活委派给后台 Agent 去干。为什么选桌面 Orb 助手普通聊天机器人只活在窗口里而 qwen-audio-agent 桌面版把语音助手做成了常驻桌面的形态悬浮球常驻Orb 悬浮在桌面上随时可说不占窗口焦点语音即界面说一句你好就能转写、回答支持文字、图片、文件附件前后台分离前台负责实时对话后台 Agent 负责干活进度和结果会回到对话里免部署安装包已内置 Gateway 与运行环境不需要额外安装 Node.js 或 npm。它的分工很清晰左侧的实时模型如qwen-audio-3.0-realtime负责自然聊天、即时回答右侧的 Agent Runtime 负责委派更深入的工作如搜索、推理。两者通过 context / response 互相衔接你可以一边聊天一边看它干活。5 分钟安装悬浮 Orb桌面应用一键安装步骤第 1 步下载安装包从项目的正式发布页下载对应平台的安装包桌面版安装说明见 docs/getting-started/install.zh.md平台安装方式macOS打开.dmg将 Qwen Audio Agent 拖入应用程序再打开应用Windows运行.exe安装程序按向导完成安装第 2 步填写语音凭据首次启动会自动创建config.env。打开设置页填写语音前台所需凭据默认使用 DashScope可以点设置里的入口前往百炼控制台获取 API Key填好后点击应用。第 3 步选择后台 Agent可选想让它会干活选择一个已安装的后台 Agent它会沿用各自的登录和模型配置只想语音聊天选仅前台模式即可之后随时可补配后台。第 4 步说第一句话允许麦克风权限说一句你好——看到转写、听到回复就说明你的桌面 Orb 助手已经跑起来了 ✅悬浮 Orb 与对话面板怎么用悬浮球和对话面板是同一客户端的两种展示形态切换不会另开语音连接点悬浮球旁的打开对话按钮展开对话面板面板里可以查看对话与工作卡片输入文字、添加图片或文件点面板中的收起按钮切回悬浮球。两个容易踩坑的细节点击悬浮球本身不会切换静音收音由麦克风按钮控制静音不影响正在播放或之后到达的回复。面板与 Orb 的窗口、布局逻辑分别实现在 desktop/src/orb-shell.mjs 和 desktop/src/desktop-surface-layout.mjs应用入口是 desktop/src/main.mjs想深入看源码可以从这几个文件入手。唤醒词与自动休眠Orb 助手如何优雅退下长时间不聊Orb 会自动隐藏你直接说可以退下了也行。休眠 隐藏界面并停止向语音前台发送麦克风输入但Realtime 连接和上下文都保留着后台任务不会取消。唤醒方式有两种菜单栏 / 快捷键macOS 默认⇧⌘ Space按键可在设置里修改唤醒词启用后休眠时麦克风只做本地关键词检测说你好千问即可唤醒。首次启用会下载约 33 MB 的 sherpa-onnx 模型检测在桌面客户端独立 Worker 中运行唤醒词音频不上传。唤醒词相关源码位于 desktop/src/wake-word/。切换外观与导入桌宠皮肤在设置 → 应用程序 → 外观可以切换内置的流光声波球、液态渐变球或导入自定义桌宠皮肤皮肤包支持 Codex pet 目录、pet.json或 zip 包三种形式导入后可在外观列表选择或删除制作皮肤可参考桌宠皮肤协议动画帧规则见桌面动画对接皮肤的管理逻辑在 desktop/src/skin-store.mjs设置页则是 desktop/src/settings.html 与 desktop/src/settings.js。进阶让 Orb 助手连接后台 Agent 干活只配语音前台时Orb 是能聊会搜索的对话助手接上后台 Agent 后它就能查询电脑、操作文件、执行代码。整体接入架构如下图前台实时对话 → Gateway 协调 → 后台持久执行默认由桌面应用管理所选后台 Agent支持外部服务的 Agent目前 OpenClaw可选手动连接现有服务填服务地址和可选令牌——注意连的是后台 Agent 服务不是把桌面客户端切到另一台 Gateway想让手机或另一台电脑也接入可在设置 → 应用程序 → Gateway填写远程地址并粘贴连接链接完成配对详见远程连接与配对。不出错的关键点数据目录与自动更新配置共享、状态独立桌面版与 CLI 默认共用~/.config/qwaudio/config.env、记忆和工作区但运行时目录各自独立两者可以同时运行自动更新设置页可检查更新下载完成后重启安装更新逻辑见 desktop/src/updater.mjs退出应用只会停掉它自己启动的 Gateway 与后台进程不会误伤借用或远程的服务日志排查从设置 → 应用程序 → 日志可打开日志目录日志会脱敏和轮转。遇到问题时优先看这份故障排查文档配置已填写不等于凭据已验证最常见的报错都出在 API Key 和额度上。下一步装好 Orb 只是开始。接下来建议按这个顺序探索读一遍桌面版指南熟悉悬浮球、休眠与外观配一个后台 Agent试试查询这台电脑的内存容量这类会生成工作卡片的任务看看快速开始里 CLI 与 WebUI 的玩法同一个 Gateway 生态在终端和浏览器里同样好用。现在去桌面上召唤你的悬浮语音 Orb 助手吧 【免费下载链接】qwen-audio-agentA realtime voice runtime that keeps Agents talking, working, and present. Real-time Voice Runtime for AI Agents项目地址: https://gitcode.com/gh_mirrors/qw/qwen-audio-agent创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表