#7157: docs(browser): recommend openclaw managed profile as default
docs
gateway
Cluster:
Browser Enhancements and Fixes
This updates the docs to recommend using the *managed + isolated* openclaw browser profile as the default for stability.
- Suggests setting browser.defaultProfile: "openclaw" for day-to-day agent browsing/automation.
- Clarifies that chrome is the *extension relay* profile and requires attaching a tab via the OpenClaw Browser Relay toolbar icon (badge ON).
- Keeps the relay flow as an explicit choice when you want to drive your existing browser session.
No runtime / behavior changes — documentation only.
<!-- greptile_comment -->
<h2>Greptile Overview</h2>
<h3>Greptile Summary</h3>
This PR updates browser-related documentation to recommend using the OpenClaw-managed `openclaw` browser profile as the default (`browser.defaultProfile: "openclaw"`) for day-to-day automation, and clarifies that the `chrome` profile is specifically for the Browser Relay extension flow (requires manually attaching a tab via the extension toolbar icon/badge).
Changes are limited to docs (`docs/gateway/configuration.md`, `docs/tools/browser.md`, `docs/tools/index.md`) and align the configuration snippet and tool reference notes around the new recommended default.
<h3>Confidence Score: 5/5</h3>
- This PR is safe to merge; it is documentation-only and internally consistent.
- Reviewed all diffs in the three modified docs files and checked for consistency with other docs references to `browser.defaultProfile` and the Browser Relay attachment flow. No broken internal links, misleading defaults, or conflicting guidance introduced.
- No files require special attention
<!-- greptile_other_comments_section -->
<sub>(4/5) You can add custom instructions or style guidelines for the agent [here](https://app.greptile.com/review/github)!</sub>
**Context used:**
- Context from `dashboard` - CLAUDE.md ([source](https://app.greptile.com/review/custom-context?memory=fd949e91-5c3a-4ab5-90a1-cbe184fd6ce8))
- Context from `dashboard` - AGENTS.md ([source](https://app.greptile.com/review/custom-context?memory=0d0c8278-ef8e-4d6c-ab21-f5527e322f13))
<!-- /greptile_comment -->
Most Similar PRs
#6193: fix(browser): default to openclaw profile instead of chrome extensi...
by mikezaoldyeck · 2026-02-01
87.3%
#14944: fix(browser): prefer openclaw profile in headless/noSandbox environ...
by BenediktSchackenberg · 2026-02-12
83.0%
#6751: docs(browser): update JSON configuration format in documentation
by saltapp · 2026-02-02
79.8%
#7252: docs: align config examples and tool docs with current runtime
by nice-and-precise · 2026-02-02
79.3%
#9020: fix(browser): skip port ownership and WS reachability checks for re...
by yepack · 2026-02-04
77.7%
#12834: docs(gateway): clarify there is no standalone clawrouter binary
by JBrady · 2026-02-09
77.6%
#10894: Docs: fix legacy branding, add config reference, expand cron troubl...
by biv0711 · 2026-02-07
77.1%
#11915: Docs: Docker + reverse proxy deployment notes and pairing pitfalls
by walshd1 · 2026-02-08
76.9%
#22952: fix(browser): suggest remote profile when local Chrome is not insta...
by dashed · 2026-02-21
76.5%
#10367: CLI/Ops: resilient browser fill + failover hardening + operations t...
by cluster2600 · 2026-02-06
76.1%