What problem does it solve?
Provides clear rules for safely attaching, creating, and managing browser tabs when using OpenClaw with BrowserForce so agents do not prompt users unnecessarily, create unsafe navigation flows, or enter repetitive error loops.
Core Features & Use Cases
- Avoid unsolicited attach prompts: Do not ask the user to click Attach/Share by default, reducing friction and surprise prompts.
- Deterministic tab handling: If no tabs or targets exist, create or reuse a dedicated tab using context.newPage(), navigate, and call snapshot() to capture context for the agent.
- Respect user mode flags: Only request manual Attach/Share when mode=manual, noNewTabs=true, or the user explicitly asks to use their current tab.
- Actionable error reporting: When blocked, report one concrete reason and one concrete user action to resolve the block.
- Loop prevention: Avoid repeating "click extension icon again" loops unless a new error signal appears.
- Use Case: Run a web automation that needs a live authenticated tab: in auto mode the agent should create and snapshot a dedicated tab, while in manual mode it should ask the user to attach a trusted tab.
Quick Start
Attach in auto mode or create a dedicated new tab when no targets exist, then capture the page state with snapshot() and proceed with safe automation.