先选择使用方式；桌面版不需要先走 CLI 安装流程。
| 我想要 | 从这里开始 |
|---|---|
| 打开应用就能聊 | 桌面版：下载安装、填写设置、开始对话。 |
| 从终端或浏览器使用 | 按下面的命令行步骤启动 Gateway，再连接 TUI 或 WebUI。 |
| 手机 / 另一台电脑接入 | 远程连接与配对：Gateway 在电脑或服务器上运行。 |
| 开发自己的客户端或适配器 | 开发者扩展总览。 |
尚未安装 CLI 时，先看安装。
qwenaudio config命令会显示配置文件路径，并创建带注释的 config.env 模板。
最小配置只需要 DashScope API Key：
DASHSCOPE_API_KEY=your-key需要执行后台任务时，选择已经安装并配置好的 Agent（下面以 Qwen Code 为例）；后台模型可留空：
DASHSCOPE_API_KEY=your-key
# 语音前台模型：flash 低延迟更省，plus（默认）质量更好
QWEN_AUDIO_REALTIME_MODEL=qwen-audio-3.0-realtime-plus
# 后台 Agent：留空或设为 none 时启动仅前台模式
AGENT_PROTOCOL=qwen
# 后台模型：显式设置通过 ACP 标准覆盖；留空沿用 Agent 配置
QWEN_AUDIO_AGENT_BACKEND_MODEL=没有现成后台时，可选用支持一键托管的 OpenCode / OpenClaw。
默认使用 DashScope 实时语音前台；也可切换为 speech-to-speech 前台，选择全本地模型链路时无需云端 API Key。
在一个终端中启动 Gateway：
qwenaudio另开一个终端，启动 TUI：
qwenaudio tui也可以使用浏览器界面（默认 http://127.0.0.1:3101）：
qwenaudio webui打开麦克风权限后，说一句“你好”，确认能看到转写并听到回答。 已配置后台时，再试“查一下这台电脑的内存容量”，观察工作卡片与结果。 没有声音或显示连接错误时，按故障排查检查。
测试不同客户端时，同一用户在同一个 Gateway 上只有一个活动连接；新客户端可以
在确认后接管，原客户端会断开。结束终端运行时按 Ctrl-C。
不设置 AGENT_PROTOCOL（或设为 none）时，Gateway 不启动后台 Agent；聊天及已启用的前台工具仍可使用。
需要后台执行的请求会返回明确说明，不会创建任务或猜测执行结果。也可以用
qwenaudio --backend none 显式启动仅前台模式。
后台 Agent 的选择、一键安装、权限模式和常驻服务见 后台 Agent，更多配置项见 配置说明，TUI 平台差异见 TUI 注意，浏览器客户端见 WebUI。