Qwen Audio Agent 是一个实时语音运行时,让 AI 智能体在持续语音对话的同时执行后台任务,并在任务完成后自然地把结果反馈到进行中的对话中。
用途:用于需要“边说话边干活”的语音智能体场景,例如语音驱动代码审查、数据分析、项目初始化等。
主要能力:支持全双工实时语音与自然打断;前端对话与后台任务并行;任务结果自动回填对话;支持多种后端智能体(OpenCode、OpenClaw、Qoder、Kimi Code、Hermes 及自定义 ACP);跨会话记忆与用户画像;提供 WebUI、终端 TUI、macOS 桌面应用三种界面。
使用方式:需 Node.js 22.22.2+ 或 24.15.0+、npm 10+ 及 DashScope API Key。全局安装:npm install -g qwen-audio-agent。用 qwenaudio config 生成 ~/.config/qwaudio/config.env,填入 DASHSCOPE_API_KEY,可选设置 QWEN_AUDIO_REALTIME_MODEL、AGENT_PROTOCOL、QWEN_AUDIO_AGENT_BACKEND_MODEL。一个终端运行 qwenaudio 启动 Gateway,另一个终端运行 qwenaudio tui 或 qwenaudio webui(默认 http://localhost:3003)。TUI 中空格开始/停止说话,x 打断,Ctrl+C 退出。音频模式可选 half、full、aec。Gateway 可安装为用户服务(qwenaudio gateway install/start/stop/restart/status);Gateway WebSocket 默认 ws://localhost:3002/voice,也可通过库模式 import { Gateway } from 'qwen-audio-agent' 集成。
适用场景:语音驱动的代码审查与修改、数据获取与分析、多任务并行执行、多步项目搭建,以及仅需简单语音对话的前端-only 模式(--backend none)。
限制与注意:实时音频会发送至 DashScope;后端任务可能调用 API、执行命令或修改文件;full 权限模式会自动批准所有命令与文件变更,仅限可信项目;Gateway 默认只绑定 localhost。Linux 可能需安装 PortAudio 与 sounddevice;全双工无回声消除时需戴耳机。用户数据存于 ~/.config/qwaudio/,不云端同步。未提供的信息暂未提供。