Skip to content

WebUI

WebUI 是浏览器里的对话客户端。Gateway 在自己的源上静态托管它——不需要单独 部署前端服务。

打开方式

Gateway 运行中,在另一个终端执行:

bash
qwenaudio webui

命令会打印页面地址(默认 http://127.0.0.1:3101)并用默认浏览器打开。 首次使用时浏览器会请求麦克风权限,允许后才能语音对话。

选项:

选项含义
--url URL连接其他地址的 Gateway(默认 http://127.0.0.1:3101
--session ID复用指定的语音会话
--no-open只打印地址,不打开浏览器

能做什么

  • 全双工语音——自然说话、随时打断,实时转写同步显示。
  • 文本与图片——直接输入文字;所选 Realtime 模型支持图片输入时可附带图片。
  • 任务视图——跟随派发给后台 Agent 的后台任务,包括进度与最终结果。

与其他客户端的关系

TUI、WebUI、桌面悬浮球都使用同一套 Gateway Client Protocol。一个 Gateway 同时只接受一个活动 Client 连接;连接另一客户端前,需要先关闭当前客户端。 桌面版也可以运行自己的 Gateway 进程,并与 CLI 共享用户配置。桌面版的对话窗口 复用同一套 WebUI 页面,因此各端的展示行为保持一致。

把 WebUI 暴露到本机之外会跨越信任边界:请在前面加带认证的 HTTPS 反向 代理,并遵循远程访问安全