Clawbrowser Skill

無頭瀏覽器自動化 CLI，ARIA ref 定位，自然語言操作，OpenClaw 集成

ClawBrowser

基於 agent-browser 的 OpenClaw 瀏覽器自動化工具，專為 AI Agent 設計。

核心特性

• ✅ ARIA ref 定位 - 不用脆弱的 CSS 選擇器
• ✅ 自然語言指令 - 直接說「點擊提交按鈕」
• ✅ 無頭模式 - 只保留 DOM 渲染 + 無障礙樹快照
• ✅ 雙引擎切換 - agent-browser / traditional
• ✅ 100% 接口兼容 - 舊代碼零修改
• ✅ 網頁抓取 - extract_content/images/links

安裝依賴

bash

# 安裝 agent-browser CLI
npm install -g agent-browser
agent-browser install  # 下載 Chrome

快速開始

python

from browser_tool import BrowserTool

# 初始化
browser = BrowserTool(session_name="my_task")

# 打開網頁
browser.open("https://example.com")

# 獲取快照（包含 refs）
snapshot = browser.snapshot(interactive=True)

# 使用 ref 點擊
browser.click("@e1")

# 填寫表單
browser.fill("@e2", "[e-mail]")

# 關閉
browser.close()

核心接口

基礎操作

方法	說明
open(url)	打開網頁
snapshot()	獲取無障礙樹快照
click(selector)	點擊元素
fill(selector, text)	填寫輸入框
type(selector, text)	輸入文本
press(key)	按鍵
wait(selector)	等待
close()	關閉

獲取信息

方法	說明
get_text(selector)	獲取元素文本
get_url()	獲取當前 URL
get_title()	獲取頁面標題
get_attr(selector, attr)	獲取屬性

網頁抓取

方法	說明
extract_content()	提取頁面內容
extract_images()	提取圖片
extract_links()	提取鏈接

自然語言

python

browser.natural_language_command("打開 github.com")
browser.natural_language_command("點擊 Sign In 按鈕")
browser.natural_language_command("填寫用戶名為 admin")
browser.natural_language_command("抓取頁面內容")

雙引擎切換

python

# 全局切換
set_global_engine("agent-browser")  # 或 "traditional"

# 實例級切換
browser_ab = BrowserTool(engine="agent-browser")
browser_trad = BrowserTool(engine="traditional")

緩存配置

python

from browser_tool import GLOBAL_CONFIG

# 啟用緩存
GLOBAL_CONFIG["cache_enabled"] = True

# 設置 TTL
GLOBAL_CONFIG["cache_ttl_seconds"] = 300

適用場景

• ✅ AI Agent 瀏覽器自動化
• ✅ 網頁抓取（微信文章、新聞、博客）
• ✅ 測試自動化
• ✅ 數據采集
• ✅ RPA 流程

限制條件

• ❌ 需要 Chrome/Chromium
• ❌ 動態內容需要重新快照
• ❌ Canvas/WebGL 不支持

文件結構

text

clawbrowser-skill/
├── SKILL.md              # 本文件
├── browser_tool_py36.py  # 核心工具（Python 3.6 兼容）
├── web_scraper.py        # 網頁抓取工具
└── README.md             # 補充說明

開發者

作者: RedOpenClaw
完成日期: 2026.04.02
簽名: 🦞 RedOpenClaw - 生活太快⚡️...老逼快跑💨...

參考資源

• agent-browser 官方文檔：https://agent-browser.dev
• OpenClaw 文檔：https://docs.openclaw.ai
• ClawHub 文檔：https://github.com/openclaw/clawhub