Gateway 运行与常驻
Gateway 连接语音前台和后台 Agent，并向客户端提供对话接口。可以选择一种运行方式：
| 方式 | 启动 | 退出或停止 |
|---|---|---|
| 终端前台运行 | qwenaudio 或 qwenaudio gateway | 原终端按 Ctrl-C。 |
| 用户后台服务 | qwenaudio gateway install 安装并立即启动 | qwenaudio gateway stop；卸载用 gateway uninstall。 |
| 桌面内置 Gateway | 打开桌面应用，由应用启动和管理 | 退出应用会停止它自己启动的 Gateway，不关闭借用或远程服务。 |
从源码启动
在仓库根目录执行 npm start、npm run gateway 或 npm run cli -- gateway， 均复用同一个 CLI 启停入口；npm run gateway 还会先构建 WebUI。例如：
npm run gateway -- --backend qwen后台参数只用于 gateway run；TUI、WebUI 仅连接 Gateway，不能通过客户端命令 改变其后台。setup --backend NAME 只做检查。旧的 npm run backend 别名已移除， 请改用 npm run gateway。
地址优先级为 --url、QWEN_AUDIO_AGENT_URL、HOST / PORT （默认 127.0.0.1:3101）。HOST 为通配地址时保留监听设置，本机健康检查使用回环地址。
修改配置后生效
- 终端运行：在运行 Gateway 的终端按
Ctrl-C，再执行原启动命令。 - 后台服务：执行
qwenaudio gateway restart。未安装服务时，这条命令会报“后台服务尚未安装”。 - 桌面版：在设置页修改后点击“应用”；直接编辑文件后退出并重新打开应用。 皮肤、唤醒等客户端设置不应要求重启 Gateway。
- 远程连接：修改和重启实际运行的 Gateway；本机配置不会改变远程服务器。
后台服务不会保留只在某个终端临时 export 的凭据。持久设置写入 qwenaudio config 显示的 config.env。
后台服务命令
qwenaudio gateway install
qwenaudio gateway status
qwenaudio gateway restart
qwenaudio gateway stop
qwenaudio gateway start
qwenaudio gateway uninstall服务启动时重新读取配置。install、start 和 restart 会刷新用户命令搜索路径缓存， 使 Homebrew、npm、uv 或版本管理器安装的 Agent / stdio MCP 命令能够被发现。
实例与客户端
同一运行时目录只允许一个 Gateway。默认情况下，CLI、TUI、WebUI 使用 CLI 的实例； 桌面版运行时目录独立，可以同时启动另一个实例。两者共享配置、记忆和工作区， 但不共享任务、运行锁和日志。具体路径见配置总览。
同一 Gateway 中，每个用户只有一个活动客户端；接管会断开原连接。不要把 “多个 Gateway 实例”和“同一 Gateway 的多个客户端”混在一起。
后台进程的所有权
Gateway 负责关闭自己启动的后台进程。复用 Agent 的用户配置，不等于连接或关闭用户 已经运行的进程。OpenClaw 显式配置外部 Gateway 时只连接该服务，不负责其生命周期； 详见OpenClaw 配置。