## 一、Skill 定位

`Agent-Browser` 用来把网页上的重复动作自动化，例如登录、表单填写、信息采集、页面巡检。  
它非常适合“规则清晰、步骤固定”的场景。

## 二、适用场景

1. 每日固定抓取多个页面的数据。
2. 后台系统批量录入或状态核验。
3. 前端回归测试中的基础流程检查。
4. 舆情/竞品页面的周期性巡检。

## 三、安装与前置

### 1) 安装 skill

```bash
clawhub install agent-browser
clawhub sync --all
```

### 2) 基础依赖建议

1. 启用 OpenClaw 的浏览器工具能力。
2. 准备专用测试账号，避免使用个人主账号。
3. 配置稳定网络与重试策略。

## 四、使用方法

### Step 1：先写动作剧本

把流程拆成可执行步骤，例如：

1. 打开目标 URL。
2. 输入账号密码登录。
3. 跳转到报表页。
4. 抓取指定字段并导出。

### Step 2：在会话中执行

```text
/skill agent-browser
访问示例后台，登录后进入“订单列表”，筛选最近 7 天数据并导出 CSV。
```

### Step 3：加入容错策略

1. 元素定位失败时重试 2-3 次。
2. 页面超时切换备用入口。
3. 关键步骤截图留痕，便于排错。

### Step 4：做定时任务

将稳定流程挂到计划任务，形成自动巡检。

## 五、注意事项

1. **验证码与风控**：遇到验证码需要人工介入，不要强行绕过。
2. **账号安全**：自动化账号最小权限、单独隔离。
3. **页面变更风险**：前端改版会导致选择器失效，要定期回归。
4. **合规边界**：只抓取被授权的数据，避免违规采集。
5. **执行成本**：长流程优先拆分为多个小任务，降低失败重跑成本。

## 六、常见问题

1. 元素找不到：检查页面是否在 iframe 或 shadow DOM。
2. 登录后跳回首页：确认 session/cookie 是否保存成功。
3. 抓取数据错位：优先定位表头再映射字段，避免硬编码列序。

## 七、落地清单

1. 固化 3 个高频网页自动化场景。
2. 每个场景保留“动作剧本 + 异常处理”文档。
3. 接入执行日志与截图存档。
4. 每月做一次选择器健康检查。
5. 高风险页面统一人工复核。

## 八、参考资料

1. Agent-Browser Skill：https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/agent-browser
2. OpenClaw Skills 文档：https://docs.openclaw.ai/skills