openclaw - 💡(How to fix) Fix Add headless option to browser profile config [1 comments, 1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#71661Fetched 2026-04-26 05:10:08
View on GitHub
Comments
1
Participants
1
Timeline
2
Reactions
0
Author
Participants
Timeline (top)
closed ×1commented ×1

Error Message

Error: Chrome CDP websocket for profile "openclaw" is not reachable after start.

Root Cause

OpenClaw's browser tool fails to start on headless Mac minis (no display attached) because Chrome is launched in non-headless mode by default. The error is:

Code Example

Error: Chrome CDP websocket for profile "openclaw" is not reachable after start.

---

{
  "browser": {
    "profiles": {
      "openclaw": {
        "headless": true,
        "color": "#FF4500"
      }
    }
  }
}
RAW_BUFFERClick to expand / collapse

Problem

OpenClaw's browser tool fails to start on headless Mac minis (no display attached) because Chrome is launched in non-headless mode by default. The error is:

Error: Chrome CDP websocket for profile "openclaw" is not reachable after start.

Chrome logs show CVDisplayLinkCreateWithCGDisplay failed. CVReturn: -6670 — macOS can't create a display link without a monitor.

Manually launching Chrome with --headless=new on the same machine works perfectly — CDP connects fine and pages load.

Current Schema

The browser profile schema (browser.profiles.<name>) supports: cdpPort, cdpUrl, userDataDir, driver, attachOnly, color.

There is no headless option.

Proposed Solution

Add a headless boolean to the browser profile schema:

{
  "browser": {
    "profiles": {
      "openclaw": {
        "headless": true,
        "color": "#FF4500"
      }
    }
  }
}

When headless: true, pass --headless=new to Chrome on launch.

Environment

  • OpenClaw 2026.4.11
  • macOS (Apple Silicon, Mac mini, no display attached)
  • Chrome 147.0.7727.103

extent analysis

TL;DR

Add a headless option to the browser profile schema and set it to true to launch Chrome in headless mode.

Guidance

  • Verify that the headless option is correctly added to the browser profile schema by checking the schema documentation or code.
  • Test the proposed solution by setting headless to true in the browser profile configuration and checking if Chrome launches in headless mode.
  • Ensure that the Chrome version used supports the --headless=new flag.
  • Consider adding error handling to handle cases where the headless option is not supported or Chrome fails to launch in headless mode.

Example

{
  "browser": {
    "profiles": {
      "openclaw": {
        "headless": true,
        "color": "#FF4500"
      }
    }
  }
}

Notes

The proposed solution assumes that the headless option will be correctly implemented and that Chrome will launch in headless mode when the option is set to true. However, this may not work if there are other issues with the Chrome configuration or the environment.

Recommendation

Apply the proposed solution by adding the headless option to the browser profile schema and setting it to true, as this is the most straightforward way to resolve the issue.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - 💡(How to fix) Fix Add headless option to browser profile config [1 comments, 1 participants]