Playwright 浏览器技能

目的

该技能使 OpenClaw 能够启动真实的 Chrome/Chromium 浏览器（非无头模式），导航至网站，并通过以下方式提取内容：

1. 抓取渲染后的 DOM 内容
拦截并捕获网络响应（XHR/Fetch API 调用）
查找并点击链接
在页面内容中搜索关键词
聚焦特定元素

前置条件

确保已安装 Playwright：
bash
pip install playwright
playwright install chromium

使用方法

1. 基本导航与内容提取

python
from skills.playwright-browser.scripts.browser_agent import SyncBrowserAgent

agent = SyncBrowserAgent(headless=False)
content = agent.getpagecontent(https://example.com)
print(f标题: {content[title]})
agent.close()

2. 查找并点击链接

python
from skills.playwright-browser.scripts.browser_agent import SyncBrowserAgent

agent = SyncBrowserAgent(headless=False)
agent.navigate(https://sina.com)

查找包含特定文本的链接

links = agent.findlinksby_text(军事) for link in links: print(f找到: {link[text]} -> {link[href]})

点击第一个匹配的链接

agent.findlinkand_click(军事)

agent.close()

3. 搜索页面内容

python
agent = SyncBrowserAgent(headless=False)
agent.navigate(https://mil.news.sina.com.cn/)

在页面中搜索关键词

results = agent.searchpagecontent(伊朗) for r in results: print(f找到: {r[text]})

聚焦第一个结果

if results: agent.focusonelement(results[0])

agent.close()

4. 拦截网络响应

python
agent = SyncBrowserAgent(headless=False)

def onapiresponse(response):
if response.resource_type in [xhr, fetch]:
print(fAPI: {response.url})

agent.hooknetworkresponses(onapiresponse)
agent.navigate(https://spa-app.example.com)

获取所有捕获的 API 调用

apicalls = agent.getcapturedapicalls() agent.close()

安全指南

- 切勿导航至可疑或潜在恶意的 URL
始终在导航前验证 URL
遵守 robots.txt 和网站服务条款
在访问可能包含敏感内容的网站时提醒用户
使用完毕后关闭浏览器以释放资源

Playwright浏览器