Browser
自动化 浏览器与自动化安装命令
npx clawhub@latest install browser-automation
安装说明
1
确认环境
确保已安装 Node.js 22+ 和 OpenClaw。在终端运行 openclaw --version 确认 OpenClaw 正常工作。
2
执行安装
在终端中运行上方安装命令，ClawHub 会自动下载并安装 Browser 到 ~/.openclaw/skills/ 目录。
3
验证安装
运行 openclaw skills list 查看已安装技能列表，确认 Browser 已出现在列表中。
4
配置参数（可选）
根据下方介绍中的配置说明，在 ~/.config/openclaw/openclaw.json5 中添加技能的配置项。
手动安装方式：将 Skill 文件夹复制到
~/.openclaw/skills/ 或项目目录下的 skills/ 文件夹，确保文件夹中包含 SKILL.md 文件。
多浏览器支持
截图与PDF
页面交互
详细介绍
Browser 是 OpenClaw 内置的浏览器控制能力，基于 Playwright 驱动，支持多种部署模式。
三种运行模式
- OpenClaw 托管浏览器：启动隔离的 Chrome/Brave/Edge/Chromium 实例
- Chrome 扩展中继：控制现有 Chrome 标签页
- 远程 CDP：连接远程浏览器服务（Browserless、Browserbase 等）
功能清单
标签页管理：获取列表、打开、聚焦、关闭标签页
检查能力：快照（AI 格式/ARIA 格式）、截图（整页或元素级）、PDF 导出、控制台日志/网络请求追踪
交互操作：导航、点击、输入、拖拽、悬停、表单填充、文件上传/下载、滚动、对话框处理、等待条件
状态管理：Cookie 读写、LocalStorage/SessionStorage、离线模式、自定义请求头、地理位置/时区/语言/设备模拟
配置参数
在 openclaw.json5 中配置：
{
browser: {
enabled: true, // 是否启用浏览器控制
defaultProfile: "openclaw", // 配置：openclaw（托管）| chrome（扩展）
headless: false, // 是否无头模式
executablePath: "", // 自定义浏览器路径
ssrfPolicy: {
dangerouslyAllowPrivateNetwork: false // 是否允许访问私有网络
},
profiles: {
openclaw: { cdpPort: 18800 }, // 托管模式 CDP 端口范围 18800-18899
work: { cdpPort: 18900 } // 可配置多个命名配置
}
}
}
远程 CDP 连接示例：
{
browser: {
profiles: {
remote: {
cdpUrl: "wss://provider.example?apiKey=KEY"
}
}
}
}
CLI 命令参考
- 基础：
status | start | stop | tabs | open | focus | close | navigate | screenshot | snapshot | pdf - 操作：
click | type | press | hover | drag | select | download | upload | wait | dialog | evaluate - 状态：
cookies | storage | set (offline | headers | credentials | geo | media | timezone | locale | device)
所有命令支持 --browser-profile <name> 和 --json 输出。
安全特性
浏览器控制仅限回环访问，通过网关认证或节点配对流动进行访问控制。SSRF 防护在导航前后生效，支持私有网络白名单。