项目介绍
Browser Use 将模型决策与浏览器操作连接起来,适合页面检索和可界定的自动化流程。任务应明确允许操作的站点和结束条件。
代理获取页面状态并结合模型选择下一步,浏览器执行后再返回结果。任务目标、允许页面和结束条件决定流程是否可控。
适合可界定的网页检索与交互。先验证只读任务,再增加填写和提交,保留每次动作与页面结果。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 页面读取 | 理解当前文本与元素 |
| 模型决策 | 按目标选择动作 |
| 浏览器控制 | 执行点击输入和导航 |
| 轨迹记录 | 追踪失败步骤 |
| 任务终止 | 用明确结果判断完成 |
界面展示

图 1:官方仓库提供的项目示意图,用于说明功能与布局。
项目信息
| 项目 | 说明 |
|---|---|
| 类型 | 项目指南 |
| 分类 | AI 与开发 |
| 项目仓库 | browser-use/browser-use |
| 整理日期 | 2026-11-14 |
安装与运行
在开发电脑或 Linux/WSL 安装 uv。本教程沿用当前 README 的 1.0.3 命令行方案;浏览器连接与云端 API 使用自己的账号。
1. 安装和初始化
uv tool install browser-use==1.0.3
browser-use --help
browser-use --doctor
2. 第一次使用
先根据 doctor 输出补齐浏览器连接条件,再按照帮助选择运行方式。需要接入支持 Skills 的工具时,运行 browser-use skill install。使用独立浏览器配置测试打开公开页面和提取标题,确认过程可回看后再接入自己的资料。
常见问题
- 命令不存在:确认依赖已安装,关闭并重新打开终端,再检查实际使用的环境。Python 虚拟环境与系统 Python、Windows 与 WSL 的工具路径各自独立。
- 下载依赖失败:先查看具体失败的仓库和包名,检查该终端的网络;浏览器能访问不代表命令行已使用同一代理。
- 配置后仍报错:从当前项目目录启动,检查配置文件名、变量名和日志。真实账号与 API Key 放在本机私有配置中,不复制到公开教程或截图。
更新与备份
更新前保存项目配置、输入资料和输出结果。源码项目记录当前提交与依赖锁文件,比较新版本说明后再更新;安装包项目保留可回退的版本号。服务账号的授权与模型账单在对应平台管理,删除本地目录不会自动撤销授权。