操作 Chrome 浏览器
连接指定 Chrome 配置档,使用已有标签和登录会话,并检查扩展重复安装。
This page has not been translated into English yet. The original Chinese version is shown below.
Browser Use 可以在 Chrome 现有标签和登录会话中操作网页。它需要 Chrome 浏览器扩展,单独安装 Qwen Code 不会附带该扩展。
支持环境
官方当前要求 macOS 或 Linux、Chrome 125 及以上、Qwen Code 0.24.2 及以上。用 qwen --version 确认 CLI 版本,再在实际要使用的 Chrome profile 中安装 Qwen Code Chrome 扩展。
每个 profile 保留一份扩展。若曾加载开发版 unpacked 扩展,应在 chrome://extensions 移除或禁用那份副本,否则同一 profile 会显示成两个浏览器,连接可能落到任意一份。
开始任务
直接描述浏览器任务,例如“读取已打开的订单面板并总结待处理项目”。Qwen 在适用时选择 browser-use Skill,先确认与扩展连接,再操作页面。
第一次浏览器任务会在用户目录注册一个本地连接程序,之后复用。若首次运行依赖还需配置,会给出指引,可能要求重启。这里不需要另装 Browser Use 类型的 Qwen 扩展,也不需要启动 qwen serve。
连接失败
先确认 Chrome 已打开、CLI 版本符合要求、扩展在目标 profile 启用,再重试。商店安装后由 Chrome 更新扩展;商店所在区域不可用时,官方提供源码构建路线,应按仓库 packages/chrome-extension README 构建,然后在开发者模式 Load unpacked 选择 dist/extension。
不要把“在另一个 profile 中安装成功”当成当前浏览器可连接的证据,也不要用重复安装副本解决连接问题。
禁用的范围
/skills 中禁用 browser-use 会让模型不再发现该 Skill,但不会断开现有浏览器会话,也不会移除当前对话已经加载的指令。需要结束已建立连接时,不能只依据列表中已隐藏判断完成。