一句话定义

  • 这一组命令负责浏览器自动化、网页截图/快照、页面交互，以及定时任务、hooks、webhooks 等自动化能力。

解决的问题

  • 如何用 OpenClaw 的浏览器去打开页面、点击、输入、截图
  • 如何查看标签页、console、network 请求
  • 如何创建定时任务
  • 如何接 webhook 或管理 hooks

核心机制

  • browser：控制 OpenClaw 专用浏览器。
  • cron：做定时调度。
  • hooks：管理内部 agent hooks。
  • webhooks：对接 webhook 类集成。
  • 这部分是 OpenClaw 自动化能力最强的一组命令面。

关键组成

1. 浏览器基础管理

openclaw browser status
openclaw browser doctor
openclaw browser start
openclaw browser stop
openclaw browser tabs
openclaw browser tab  -- 索引快捷切换
openclaw browser open https://example.com
openclaw browser focus <targetId>
openclaw browser close <targetId>
openclaw browser set  -- 环境设置

2. 浏览器查看与取证

openclaw browser screenshot
openclaw browser screenshot --full-page
openclaw browser snapshot
openclaw browser snapshot --format aria --limit 200
openclaw browser console
openclaw browser errors
openclaw browser requests
openclaw browser responsebody
openclaw browser pdf
openclaw browser trace

3. 浏览器页面交互

openclaw browser navigate https://example.com
openclaw browser click 12 --double
openclaw browser click-coords 120 340
openclaw browser type 23 "hello" --submit
openclaw browser press Enter
openclaw browser hover 44
openclaw browser drag 10 11
openclaw browser select 9 OptionA
openclaw browser fill --fields '[{"ref":"1","value":"Ada"}]'
openclaw browser dialog --accept
openclaw browser evaluate --fn '(el) => el.textContent' --ref 7
openclaw browser wait --text "Done"
openclaw browser highlight --ref 7
openclaw browser scrollintoview --ref 7
openclaw browser resize 1280 720
openclaw browser upload /tmp/file.pdf

4. 浏览器高级能力

openclaw browser profiles
openclaw browser create-profile --name work
openclaw browser delete-profile --name work
openclaw browser reset-profile
openclaw browser cookies
openclaw browser storage
openclaw browser download --ref 9
openclaw browser waitfordownload

说明：

  • 第三方网页通常只覆盖 status / open / screenshot / snapshot / click / type / press / navigate 这些基础能力。
  • v2026.5.26 的 browser 子命令完整清单：
    • 保留：click、close、console、focus、hover、open、screenshot、snapshot、start、status、stop、tabs、type
    • 新增：click-coords、cookies、create-profile、delete-profile、dialog、doctor、download、drag、errors、evaluate、fill、highlight、navigate、pdf、press、profiles、requests、reset-profile、resize、responsebody、scrollintoview、select、set、storage、tab、trace、upload、wait、waitfordownload

5. 定时任务

openclaw cron status
openclaw cron list
openclaw cron add
openclaw cron edit <id>
openclaw cron rm <id>
openclaw cron enable <id>
openclaw cron disable <id>
openclaw cron runs --id <id>
openclaw cron run <id>

6. Hooks 与 Webhooks

openclaw hooks list
openclaw hooks info <name>
openclaw hooks enable <name>
openclaw hooks disable <name>
openclaw hooks install
openclaw hooks update
openclaw webhooks gmail setup
openclaw webhooks gmail run

生命周期 / 执行流程

做一次网页自动化

  1. openclaw browser start
  2. openclaw browser open <url>
  3. openclaw browser snapshot
  4. 按 ref 执行 click / type / select / fill
  5. 必要时 screenshot / console / requests

新建定时任务

  1. openclaw cron list
  2. openclaw cron add
  3. openclaw cron run <id> 做调试
  4. openclaw cron runs --id <id> 看历史结果

排查网页自动化失败

  1. browser snapshot
  2. browser console
  3. browser errors
  4. browser requests
  5. 必要时 browser trace

高频命令组合

快速查看网页

openclaw browser open https://example.com
openclaw browser snapshot
openclaw browser screenshot --full-page

表单自动化

openclaw browser snapshot
openclaw browser type 23 "hello" --submit
openclaw browser wait --text "Done"

定时任务排查

openclaw cron list
openclaw cron run <id>
openclaw cron runs --id <id>

边界与限制

  • browser 很强，但 ref 与页面状态是时效性的，页面刷新后可能需要重新 snapshot。
  • cron 是调度层，不等于业务逻辑本身，任务内容仍需清晰设计。
  • hooks 和 webhooks 更偏框架自动化集成，不一定是所有日常用户都会直接频繁用。

常见误区

  • 误区 1：截图后立刻点击旧 ref。正确做法通常是 snapshot → 操作 → 必要时再 snapshot。
  • 误区 2：只用 screenshot 调试交互问题。很多时候更有价值的是 snapshot / console / requests / errors。
  • 误区 3：cron run 成功一次，就等于定时调度没问题。仍要检查 runs 历史与调度条件。

对比项

  • browser screenshot：视觉结果
  • browser snapshot：结构化页面快照
  • browser console / errors / requests：调试信息
  • cron：定时调度
  • hooks / webhooks：自动化集成