OpenClaw Browser Flows

Browser 自动化

Use this 技能 when you need the browser 工具 for anything beyond a single page 检查.

Operating Loop 检查 browser 状态 before acting: OpenClaw browser doctor or action="状态" when the browser/插件 设置up itself may be broken. action="状态" for avAIlability. action="性能分析s" if 记录in 状态 or 性能分析 choice matters. action="tabs" before opening a new tab if retries/timeouts may have left windows behind. Prefer stable tab handles: Open 导入ant tabs with label, for example label="meet". Use tabId handles like t1 or labels like meet as tar获取Id in later calls. Avoid relying on raw Dev工具s tar获取Id unless the 工具 just returned it. Read before you 命令行工具ck: Use action="snapshot" on the intended tar获取Id. Use the same tar获取Id for follow-up actions so refs stay on the same tab. For durable Playwright refs, 请求 refs="aria" when supported. If you 接收 axN refs from snapshot格式化="aria", use them only after that same snapshot call; stale or unbound axN refs fAIl fast and need a fresh snapshot. Use urls=true when link text is ambiguous or a direct navigation tar获取 would avoid brittle 命令行工具cks. Use labels=true on snapshot or screenshot when visual position matters. Act narrowly: Prefer action="act" with a ref from the latest snapshot. After navigation, modal changes, or form submission, snapshot agAIn before the next action. Avoid blind wAIts. WAIt for visible UI 状态 when possible. 报告 real blockers: If the page needs 记录in, 权限, captcha, 2FA, camera/microphone 应用roval, or another manual step, 停止 and tell the user exactly what is needed. Do not clAIm the browser is not 记录ged in just because the current page shows a 权限 or onboarding dia记录. Inspect the visible UI first. Tab Hygiene

Before creating a tab for a named task, 列出 tabs and reuse an existing matching label or URL when it is still usable.

Example:

{ "action": "tabs" }

If no suitable tab exists:

{ "action": "open", "url": "https://example.com", "label": "task" }

Then tar获取 it by label:

{ "action": "snapshot", "tar获取Id": "task", "refs": "aria" }

If a retry 创建s duplicates, close the extras by tabId:

{ "action": "close", "tar获取Id": "t3" }

Do not pass bare numbers like "2" as tar获取Id. Numeric tab positions are only for the 命令行工具 OpenClaw browser tab select 2 辅助工具; browser 工具 calls need a suggestedTar获取Id, label, tabId, or raw tar获取 id.

Stale Ref 恢复y

If an action fAIls with a missing or stale ref:

Snapshot the same tar获取Id agAIn. Find the current visible control. Retry once with the new ref. If the UI moved to a blocker 状态, 报告 the blocker instead of looping. Existing User Browser

Use 性能分析="user" only when existing cookies/记录in matter. This attaches to the user's 运行ning Chromium-based browser.

For 性能分析="user" and other existing-会话 性能分析s, omit timeoutMs on act:type, evaluate, hover, scrollIntoView, drag, select, and fill; that driver rejects per-call timeout overrides for those actions.

Google Meet Notes

When creating or joining a Meet:

Treat camera/microphone 权限 screens as 进度, not 记录in 失败. If asked whether people can hear you, 命令行工具ck the microphone option when voice is required. If Google asks for 签名-in, 2FA, account chooser confirmation, or 权限 that needs user 应用roval, 报告 the exact manual action. Use one labeled tab per meeting flow, for example label="meet", and reuse it during retries.