前言¶
Agent 要幫用戶「打開頁面、填表、點按鈕、截圖或從頁面取數」，常見做法是接 Playwright/Puppeteer，或在對話裏堆一長串瀏覽器 API 說明。前者依賴重、上下文佔得多；後者指令容易和實際安裝的 CLI 版本對不上。
Agent Browser 把瀏覽器自動化收成獨立 CLI，並通過無障礙樹快照和緊湊的元素引用（@eN）把「頁面上有什麼、點哪裏」變成 Agent 好消費的文本。下面介紹它是什麼、能做什麼，以及如何在 SkillHub / OpenClaw 與 npm 兩條路徑上啓用。
這是什麼¶
Agent Browser 是面向 AI 代理的瀏覽器自動化命令行工具。維護者爲 Nicolas Kleiber（rez0），在 SkillHub 上的座標爲 @clawhub_rez0/agent-browser，版本 1.0.0，分類 ai-agent，上游見 ClawHub 技能頁。Skill 元數據標註 requires_api_key=false，安裝 Skill 本身不強制要求 API Key。
SkillHub 上的定位是：當用戶需要與網站交互——瀏覽頁面、填寫表單、點擊按鈕、截圖等——時使用該 Skill。底層 CLI 通過 Chrome/Chromium 的 CDP 驅動瀏覽器，強調無障礙樹快照與 @eN 元素引用，便於 Agent 做精準點擊與填寫，而不必在對話裏維護完整 DOM。
核心功能¶
以下能力均來自官方 Skill 頁與上游倉庫說明，不含未覈實項。
- 網頁自動化：導航、填表、點擊、截圖、從頁面提取數據、Web 應用測試等常見瀏覽器任務。
- 無障礙樹快照：輸出可讀的頁面結構，並用
@eN形式引用元素，減少「選錯選擇器」帶來的誤操作。 - 原生 Rust CLI：官方說明其爲 Rust 實現，非 Node 包裝層；通過 CDP 連接 Chrome/Chromium，不依賴 Playwright 或 Puppeteer。
- 與多種 Agent 客戶端配合：官方列舉 Cursor、Claude Code、Codex、Continue、Windsurf 等；Skill 層負責在合適場景觸發「用 agent-browser 而不是內置瀏覽器工具」的工作流。
- 會話與狀態：上游提到 sessions、認證 vault、狀態持久化、錄像等能力（具體命令以已安裝版本的
skills get core爲準）。 - 擴展 Skill 包（通過 CLI 按需加載）：
-electron：Electron 桌面應用（VS Code、Slack、Discord、Figma 等）
-slack：Slack 工作區自動化
-dogfood：探索性測試 / QA
-vercel-sandbox：在 Vercel Sandbox microVM 中運行
-agentcore：AWS Bedrock AgentCore 雲瀏覽器
ClawHub 頁面還列出典型觸發語：例如「打開某網站」「填表單」「點按鈕」「截圖」「從頁面抓數據」「登錄站點」等；是否走 Agent Browser 由 Agent 結合 Skill 說明判斷。
安裝與啓用¶
Agent Browser 有兩層：npm 全局 CLI（真正執行瀏覽器操作）和 Skill 包（告訴 Agent 何時、如何用 CLI）。兩條路徑可組合使用。
1. 安裝 CLI（npm）¶
官方安裝命令：
npm i -g agent-browser && agent-browser install
agent-browser install 用於準備 CLI 所需的瀏覽器/運行時組件（具體步驟以命令輸出爲準）。
2. 在 SkillHub 安裝 Skill（Cursor 等）¶
SkillHub 頁面給出的安裝指引：參考 SkillHub 安裝文檔，安裝座標 @clawhub_rez0/agent-browser。
若尚未安裝 SkillHub CLI，可先檢查：
command -v skillhub && skillhub --version
未安裝時可用文檔中的安裝腳本（完整安裝或 --cli-only 僅 CLI）。安裝 Skill 時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被客戶端加載。Cursor 常用路徑示例：
skillhub install @clawhub_rez0/agent-browser --dir ~/.cursor/skills/
Claude Code、Codex、Windsurf 等路徑見 SkillHub 安裝文檔第四節；按實際客戶端替換 --dir 即可。
3. OpenClaw 生態安裝 Skill¶
ClawHub 提供的 OpenClaw 安裝命令：
openclaw skills install @rez0/agent-browser
座標 @rez0/agent-browser 與 SkillHub 的 @clawhub_rez0/agent-browser 對應同一上游技能，命名空間不同。
4. 加載與 CLI 版本對齊的用法說明¶
上游倉庫中的 SKILL 發現頁強調：不要只讀本 stub，應先向 CLI 拉取與當前安裝版本一致的工作流文檔，避免文檔過期：
agent-browser skills get core # 工作流、常見模式、排錯
agent-browser skills get core --full # 含完整命令參考與模板
查看當前版本可用的擴展 Skill：
agent-browser skills list
按需加載例如：
agent-browser skills get electron
agent-browser skills get slack
典型用法¶
可復現的起步流程如下。
- 全局安裝 CLI 並執行
agent-browser install（見上一節）。 - 在所用 Agent 的 skills 目錄安裝
@clawhub_rez0/agent-browser（或 OpenClaw 的@rez0/agent-browser）。 - 在終端或讓 Agent 執行
agent-browser skills get core，按返回內容中的工作流執行具體子命令（導航、快照、通過@eN點擊等）。
官方未在靜態頁面列出完整子命令表；具體命令名與參數以 skills get core --full 輸出爲準。Agent 側典型任務描述仍與自然語言一致，例如讓用戶打開 URL、填寫字段、對 @eN 引用元素操作、截圖或導出頁面數據。
適用場景與注意¶
適合誰
- 需要 Agent 穩定操作真實瀏覽器、且希望用無障礙樹 + 元素引用降低選擇器維護成本的團隊。
- 已在 Cursor、Claude Code、Codex 等環境使用 Skills，希望統一「網站交互」觸發規則的場景。
- 除普通網頁外，還要自動化 Electron 應用、Slack，或在 Vercel Sandbox / AWS AgentCore 等環境跑瀏覽器的情況（需先
skills get對應擴展包）。
限制與注意
- 需要本機或運行環境具備 Chrome/Chromium 及 CDP 可用；CLI 安裝步驟以
agent-browser install爲準。 - Skill 描述建議 優先使用 agent-browser，而非客戶端內置的瀏覽器自動化；若同時配置多種工具，需在 Agent 規則裏避免衝突。
- SkillHub 頁面數據（截至抓取）：評分 100000，下載 1059842，安裝 36434；與 npm 包下載量可能重複統計，僅作商店熱度參考。
- 安全與審計：ClawHub 頁面提供 Security audit 入口；生產環境使用前建議按組織規範審閱權限與可訪問站點範圍。
結尾¶
Agent Browser 把「AI 要控瀏覽器」收斂成 Rust CLI + 版本綁定的 Skill 文檔：無障礙樹快照和 @eN 引用讓操作更可讀、可重複，Skill 層則把網站交互、填表、截圖等意圖映射到統一工具鏈。
- SkillHub 技能頁：https://www.skillhub.cn/skills/clawhub_rez0/agent-browser
- SkillHub API / 安裝入口：https://api.skillhub.cn/zcwl/agent-browser
- 上游說明與 OpenClaw 安裝：https://clawhub.ai/rez0/agent-browser
