Browser Use

这个 Agent 能做什么，适合哪些场景？

Browser Use 是一个 MIT 许可的浏览器代理项目，提供全托管 Cloud API、面向现有代理的 CLI，以及可嵌入应用的 Python 库。Python 接口以 Agent 接收任务，由 ChatOpenAI、ChatBrowserUse、ChatAnthropic 或 ChatGoogle 等模型封装驱动，并控制本地或云端 Browser。代理能够打开网页、执行多步骤操作，并通过运行历史的 final_result() 返回最终结果；README 展示了查询仓库星标和预约驾驶考试等流程。开发者可以通过 Tools 注册自定义动作，也可以采用结构化输出、定制系统提示以及复用浏览器身份资料。部署边界可按需要选择：自行运行代理与浏览器、只将浏览器托管到云端，或把代理和浏览器都交给全托管服务。

本地 Python 流程先从 .env 加载凭据，再用模型封装和自然语言任务构造 Agent。调用 await agent.run() 后，代理启动或连接 Browser，访问网络并完成网页交互，随后从执行历史的 final_result() 取回结果。Browser(use_cloud=True) 可改用云浏览器；Browser.from_system_chrome() 可复用本机 Chrome 配置，云端还可通过 cloud_profile_id 使用同步的 cookie。开发者能用 @tools.action 把 Python 函数注册到 Tools，再传入 Agent 扩展操作范围。CLI 路径则通过 browser-use skill install 为 Codex、Claude Code、Hermes、OpenClaw 等现有代理注册浏览器能力；全托管 Cloud API 接收任务并运行代理、浏览器及相关基础设施。

1. 需要自动完成预约流程的运营团队，可让代理查找可用时段、选择日期和时间，并提交网页操作；示例包含驾驶考试预约。
2. 已有 Codex 或 Claude Code 工作流的开发者，可安装 CLI skill，让现有代理获得浏览器访问能力。
3. 构建 Python 应用的工程师，可将 Agent 嵌入代码，选用自己的模型，并从 final_result() 获取任务结果。
4. 需要登录态自动化的团队，可复用本机 Chrome 配置，或把 cookie 同步到带 cloud_profile_id 的云浏览器。
5. 需要规模化运行网页任务的团队，可选择全托管 Cloud API，由服务负责代理、浏览器、录制、身份资料和数据策略基础设施。
6. 需要业务专用能力的开发者，可通过 Tools 注册 Python 函数，例如向代理提供当前 UTC 时间。

如何安装或部署这个 Agent？

Python 库要求 Python 3.11 或更高版本。README 建议新项目使用 Python 3.12，并通过 uv 安装：

uv init --python 3.12
uv add browser-use

在项目的 .env 中配置 OpenAI 凭据；如需 BU2 模型或云浏览器，再配置 Browser Use API 密钥：

# .env
OPENAI_API_KEY=your-key
# BROWSER_USE_API_KEY=your-key  # Optional: BU2 model or cloud browser

若要给 Codex、Claude Code、Hermes、OpenClaw 或其他现有代理安装 CLI 路径，README 提供的操作是：先用 uv 将 browser-use 安装或升级到最新稳定版并使用 Python 3.12，然后运行：

browser-use skill install

该 CLI 路径还需要连接浏览器；来源没有给出更细的逐条连接命令。

如何使用这个 Agent？

保存以下内容为 agent.py。它使用 OpenAI 模型运行一个查询 GitHub 仓库星标数的浏览器任务：

import asyncio

from browser_use import Agent, Browser, ChatBrowserUse, ChatOpenAI
from dotenv import load_dotenv

load_dotenv()

async def main():
    llm = ChatOpenAI(model='gpt-5.6-luna', reasoning_effort='xhigh')
    # llm = ChatBrowserUse(model='bu-2-0')  # Use BU2 instead; requires BROWSER_USE_API_KEY
    agent = Agent(
        task="Find the number of stars of the browser-use repo",
        llm=llm,
        # browser=Browser(use_cloud=True),  # Use a cloud browser; requires BROWSER_USE_API_KEY
    )
    history = await agent.run()
    print(history.final_result())

if __name__ == "__main__":
    asyncio.run(main())

运行脚本：

uv run agent.py

若要使用 BU2，把 ChatOpenAI 一行替换为示例中注释掉的 ChatBrowserUse(model='bu-2-0')；若要使用云浏览器，启用 Browser(use_cloud=True)。两者都需要 BROWSER_USE_API_KEY，但云浏览器可与任一模型配合。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. 0.13.14 0.13.14: Python agent and integration updates 2026-10-26
   发布说明摘录

   This release keeps the Python agent and its existing models. The Pi migration remains separate. Changes since the last PyPI release: - Add OpenAI browser tools and the shared Bash helper. - Improve bounded page observations, form state, file access, and browser recovery. - Fix temporary empty Cloud tab URLs. - Keep screenshots, crops, and clicks aligned on scaled displays. - Clean up failed browser reconnect initialization. - Improve missing-key errors for Cloud browsers. - Support Browser Use Cloud SDK V4 imports. - Update aiohttp from 3.14.3 to 3.14.5. …

   在 GitHub 查看 ↗
2. 0.13.13 0.13.13: OpenAI browser tools and Cloud fixes 2026-10-15
   发布说明摘录

   This release includes the OpenAI browser-tool driver and fixes two integration issues. - Handle temporary empty Cloud tab URLs during navigation. - Keep screenshots, crops, and pointer coordinates aligned on scaled displays. - Provide 18 default browser tools and six optional actions through Browser Use Actor. - Support local browsers, Browser Use Cloud, and borrowed browser sessions. Install the openai-tools extra with OpenAI Python 3.31+. OpenAI 3.x uses httpx2; use its DefaultAsyncHttpxClient for custom HTTP clients. …

   在 GitHub 查看 ↗
3. 0.13.12 0.13.12: OpenAI browser tools 2026-10-15
   发布说明摘录

   Add OpenAI browser tools backed by Browser Use Actor. - Import BrowserUse from browser_use.integrations.openai. - Install browser-use[openai-tools] to enable OpenAI Python 3.31+. - Use local browsers, Browser Use Cloud, or an existing connected BrowserSession. - Support the 18 default browser tools and six optional actions. - Preserve borrowed browser ownership and check Cloud browser cleanup. - Preserve URL and timeout settings across OpenAI 2.x and 3.x model wrappers. OpenAI 3.x uses httpx2. For custom HTTP clients, use OpenAI's DefaultAsyncHttpxClient. …

   在 GitHub 查看 ↗

常见问题