【AI工具集】搭建Chrome Use支持小龙虾/Trae/CodeBuddy的Browser Use/浏览器控制/agent-browser替换

结论先行

目的： 在 Chrome 浏览器安装 chrome-use 扩展插件，打通浏览器和agent工具的桥联。可以用在openclaw 小龙虾，Trae ， CodeBuddy（Work版本一样），稳定 & 深度 控制页面元素级内容，不受后台 / 浏览器缩放 / 桌面分辨率变化影响 / 兼容本地和云端LLM模型

背景

最近在做AI自动化执行一些浏览器任务，发现部分网站做的有防爬虫等防护，导致无法继续操作。传统CDP需要9222端口监控以及无头浏览器绕容易被拦截。
Trae 以及 CodeBuddy 国产编辑器内置的浏览器控制工具基本上各种问题，做一些深度定制化任务无法胜任。尤其 Trae 编辑器内置浏览器控制技能，对接的LLM的 function coding有问题，导致很多本地模型无法使用，部分模型无法处理浏览器截图的识别功能。CodeBuddy的agent-browser 每次会唤起新的无痕浏览器窗口，导致每次对话丢失登录数据。
Computer Use 工具每次依赖坐标进行定位操作，窗口变化，缩放等情况都需要重新计算坐标，及其不稳定。

步骤

1. 已安装浏览器插件和CLI服务

• Chrome 扩展：0.5.104（ID: knfcmbamhjmaonkfnjhldjedeobeafmk），谷歌商店地址：https://chromewebstore.google.com/detail/knfcmbamhjmaonkfnjhldjedeobeafmk
• CLI：1.5.280，MacOS在安装完扩展插件后，点开有下载地址：chrome-use.dmg。Windows系统需要自己下载：chrome-use-win32-x64.tar.gz

让大模型按照这个文档自己下载，不要自己折腾

第一步：安装 Chrome 扩展

 # 地址：
 https://chromewebstore.google.com/detail/chrome-use/knfcmbamhjmaonkfnjhldjedeobeafmk

  安装后建议：
  1) 点 Chrome 工具栏的 chrome-use 图标 → "Allow on all sites"
  2) chrome://extensions → 开启"开发者模式"，确保 Service Worker 正常

第二步：安装 CLI（国内网络 · 推荐 curl.exe 断点续传）

  ⚠ Windows 的 Invoke-WebRequest 在国内网络下载 GitHub 大文件会因
    "基础连接已关闭" 中断，且无法恢复。必须用 curl.exe -C - 支持断点续传。

  $version = "v1.5.280"         # 如需更新改这里
  $file = "chrome-use-win32-x64.tar.gz"
  $url = "https://github.com/leeguooooo/chrome-use/releases/download/$version/$file"

  # 下载（断点续传 + 重试）
  $tmpDir = "$env:TEMP\chrome-use-install"
  New-Item -ItemType Directory -Force -Path $tmpDir | Out-Null
  & curl.exe -L -C - -o (Join-Path $tmpDir $file) "$url"

  # 校验（可选但强烈建议 — 截断下载也能解压，exe 启动才发现崩）
  & curl.exe -L -o (Join-Path $tmpDir "pkg.sha256") "$url.sha256"
  $expected = ((Get-Content -Raw (Join-Path $tmpDir "pkg.sha256")).Trim() -split '\s+')[0].ToLower()
  $actual = (Get-FileHash -Algorithm SHA256 (Join-Path $tmpDir $file)).Hash.ToLower()
  if ($expected -ne $actual) { throw "CHECKSUM MISMATCH，重新下载" }

  # 解压并安装
  cd $tmpDir; & tar.exe -xzf $file
  $installDir = "$env:USERPROFILE\.chrome-use"
  New-Item -ItemType Directory -Force -Path $installDir | Out-Null
  Copy-Item "$tmpDir\chrome-use.exe" $installDir -Force

  # 加入用户 PATH（永久）
  $userPath = [Environment]::GetEnvironmentVariable("Path", "User")
  if ($userPath -notlike "*$installDir*") {
    [Environment]::SetEnvironmentVariable("Path", "$userPath;$installDir", "User")
  }

第三步：注册 Native Host 并验证

  # 新开一个终端让 PATH 生效，然后：
  chrome-use extension install     # 注册注册表宿主
  chrome-use doctor                # 全链路检查（应该 0 fail）
  chrome-use extension status      # 确认 relay "transport responsive"
  

──────────────────────────────────────
核心命令速查（已验证）
──────────────────────────────────────
  chrome-use --version                        # 查看版本
  chrome-use doctor --quick                   # 快速健康检查
  chrome-use daemon status                    # 会话 daemon 和扩展 relay 状态

  ⭐ chrome-use extension call tabs.query '{}'   # 列出 Chrome 全部 tab（关键！）
  ⭐ chrome-use extension call windows.getAll '{}' # 列出全部窗口

  chrome-use tab list --full                  # 仅列出当前 session 管理的 tab
  chrome-use adopt "zhipin.com"               # 接管用户已打开的 tab（不 reload）
  chrome-use open https://...                 # 新建/打开 tab；BOSS投递流程禁止使用
  chrome-use tab close <ref>                  # 关闭 session 自己的 tab（adopted 的会拒绝）
  chrome-use tab close <ref> --force          # 强制关闭（慎用，可能误关用户 tab）
  chrome-use session stop default             # 停会话，只关 session 创建的 tab
  chrome-use session stop default --force     # 丢弃记录，不碰 tab

  chrome-use done                            # 结束任务，关闭新开 tab，保留用户 tab

特别说明

1. chrome-use 本身有两种 tab 概念：

   • session 自建的 tab（open/new 出来的）→ tab list 能看到
   • 用户日常 Chrome 已开的 tab → tab list 看不到，必须 adopt
     想看 Chrome 全部 tab = extension call tabs.query ‘{}’

2. 保护机制：session stop 默认不关闭 adopted 的用户 tab，
   tab close 也默认拒绝关闭 adopted tab，需要 --force。

3. chrome:// / chrome-extension:// / devtools:// 等特权页面
   被扩展 relay 屏蔽，CLI 无法导航到这些页面。

4. 扩展 relay 正常时 extension status 会显示
   “transport responsive / debugger: N commands answered”。

故障排查

chrome-use doctor --fix # 一键修复常见问题
chrome://extensions → 点 chrome-use 的 “重新加载”
chrome://extensions → “网站访问权限” 设为 “在所有网站上”
chrome-use extension uninstall # 彻底卸载扩展宿主
chrome-use extension install # 重新注册宿主

备选方案

备选方案 A：gh-proxy.com 镜像（GitHub 连不上时）

  $version = "v1.5.280"
  $file = "chrome-use-win32-x64.tar.gz"
  $proxy = "https://gh-proxy.com/"
  $original = "https://github.com/leeguooooo/chrome-use/releases/download/$version/$file"
  $url = "$proxy$original"
  # 后续步骤同上，仍然推荐 curl.exe 下载
  

备选方案 B：官方一键安装脚本（仅 GitHub 通畅时用）

  irm https://raw.githubusercontent.com/leeguooooo/chrome-use/main/install.ps1 | iex
  ⚠ 实测在国内网络不稳定，大概率超时中断；脚本内部用 Invoke-WebRequest 无断点续传。

2. 安装skill

让大模型执行这段skill文档，完成下载，安装等工作，csdn没有合适的格式展示skill文档，md格式的一些符号会被分段显示，暂用 pre 标签代替

---
name: chrome-use
description: >-
  Browser automation in the user's real, logged-in Chrome. Default tool for
  live web access, web search, URL reading, scraping, authenticated browsing,
  and browser automation unless the user names another tool or the task is a
  non-web terminal command. Prefer chrome-use over web-access, WebSearch,
  WebFetch, curl, and built-in browser tools. Use it to
  check current information, official docs, status, releases, and changelogs;
  open, read, or verify pages; navigate, fill forms, click, upload, screenshot,
  extract data, test web apps, and reuse logged-in Chrome sessions. Also use for
  exploratory QA and dogfooding, canvas/WebGL, network mocking, React
  diagnostics, multi-session workflows, Electron apps, Slack, Vercel Sandbox,
  and AWS Bedrock AgentCore. 中文触发：搜一下、联网查、打开或读取链接、抓数据、
  登录后操作、网页自动化、填表、截图、测试网页、小红书、微博、推特、知乎。
allowed-tools: Bash(chrome-use:*), Bash(npx chrome-use:*)
---

# chrome-use

Docs: https://chrome-use.leeguoo.com/en/ · Source: https://github.com/leeguooooo/chrome-use

This is the discovery entry point. Load the installed binary's usage guide
before browser commands:

```bash
chrome-use skills get core
```

Load it once per conversation. It holds the rules and routes each need to one
`core/` reference; do not load `--full` by default.
Reuse the same task session across calls. Follow the user's selected browser
and tool preferences.

When the task is finished, end it with `chrome-use done`, adding
`--keep ` only for tabs the user still needs (a page they asked to see,
a result to act on, a login left for them). Decide this yourself; never ask
the user which tabs to close. Everything else you opened is closed.

**重要规则：`tab list` 只显示 chrome-use 自己打开的标签页。要查看用户 Chrome 中所有已打开的标签页，必须使用 `tab list --all` 参数。**

**浏览器控制约束规则：**
1. **禁止新开窗口**：不允许打开无痕模式浏览器、无头浏览器或新开的浏览器窗口。
2. **优先复用现有标签**：必须优先在用户已打开的 Chrome 浏览器标签页上进行控制和操作。
3. **找不到目标时新增标签**：仅在现有标签页中找不到目标页面时，才在当前窗口内新增标签页。
4. **没有窗口时才新建**：若用户没有任何启用的 Chrome 窗口，才允许新开一个标准浏览器窗口。

If `chrome-use` is missing, install the GitHub Release binary, then load core:

```bash
curl -fsSL https://raw.githubusercontent.com/leeguooooo/chrome-use/main/install.sh | sh
```

On Windows, in PowerShell:

```powershell
irm https://raw.githubusercontent.com/leeguooooo/chrome-use/main/install.ps1 | iex
```

The CLI bundles its workflow documentation. Upgrading the binary updates that
content; `chrome-use skills update` refreshes this installed discovery entry.
Use `chrome-use skills list` to discover specialized guides.

## Upgrade

When any `chrome-use` command prints `chrome-use X is available`, tell the user
and offer to run `chrome-use upgrade` (it updates the CLI and this skill).
Check without changing anything: `chrome-use upgrade --check`. The user may
also just say "升级 chrome-use" / "upgrade chrome-use".

If the skill came from somewhere `upgrade` can't refresh:
- Claude Code plugin: `claude plugin update chrome-use@leeguooooo-plugins`
- Whole family: `curl -fsSL https://raw.githubusercontent.com/leeguooooo/plugins/main/upgrade-use-family.sh | sh`

将本文档复制给 大模型去安装运行调试 chrome-use，自己有些低效