openclaw - 💡(How to fix) Fix [Bug]: Browser tool cannot connect to self-hosted Browserless remote CDP in Docker even though /json/version?token=... succeeds

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…

OpenClaw 2026.4.15 cannot establish a remote CDP browser connection to a self-hosted Browserless container in Docker, even though Browserless is reachable from the gateway container and authenticated GET /json/version?token=... succeeds.

Code word: lobster-biscuit

Root Cause

OpenClaw 2026.4.15 cannot establish a remote CDP browser connection to a self-hosted Browserless container in Docker, even though Browserless is reachable from the gateway container and authenticated GET /json/version?token=... succeeds.

Code word: lobster-biscuit

Code Example

"browser": {
  "enabled": true,
  "defaultProfile": "remote",
  "profiles": {
    "remote": {
      "cdpUrl": "ws://browserless:3000/?token=xxxx"
    }
  }
}

### Steps to reproduce


### Steps to reproduce

---
RAW_BUFFERClick to expand / collapse

Bug type

Regression (worked before, now fails)

Beta release blocker

No

Summary

Bug type

Behavior bug (incorrect output/state without crash)

Summary

OpenClaw 2026.4.15 cannot establish a remote CDP browser connection to a self-hosted Browserless container in Docker, even though Browserless is reachable from the gateway container and authenticated GET /json/version?token=... succeeds.

Code word: lobster-biscuit

Environment

  • OpenClaw version: 2026.4.15
  • Install method: Docker Compose
  • Gateway container: openclaw-gateway
  • Browserless container: ghcr.io/browserless/chromium:latest
  • Browserless version: 2.47.0
  • Browserless auth: TOKEN=xxxx
  • Browserless service name on Compose network: browserless
  • Browserless port: 3000

Browser profile config

"browser": {
  "enabled": true,
  "defaultProfile": "remote",
  "profiles": {
    "remote": {
      "cdpUrl": "ws://browserless:3000/?token=xxxx"
    }
  }
}

### Steps to reproduce


### Steps to reproduce

```md
1. Run OpenClaw gateway and Browserless on the same Docker Compose network.
2. Configure a browser profile with:
   `ws://browserless:3000/?token=xxxx`
3. Trigger a browser action such as a `navigate` call.
4. Observe browser tool failure.

### Expected behavior

OpenClaw should establish a remote CDP connection to Browserless and navigate normally.

### Actual behavior

OpenClaw reports:

`browser failed: Remote CDP for profile "remote" is not reachable at ws://browserless:3000/?token=xxxx`

### OpenClaw version

2026.4.15

### Operating system

Synology Linux

### Install method

docker

### Model

qwen/qwen3.6-35b-a3b

### Provider / routing chain

openclaw->lm studio

### Additional provider/model setup details

This does not look like a basic DNS/port/container problem:

- Browserless is reachable from the gateway container
- token auth works for `/json/version?token=...`
- but the CDP websocket handshake never becomes a live session

This appears to be a remote CDP websocket handshake/compatibility issue between OpenClaw's browser service and self-hosted Browserless in Docker.

### Logs, screenshots, and evidence

```shell

Impact and severity

No response

Additional information

No response

extent analysis

TL;DR

The issue is likely due to a compatibility problem between OpenClaw's browser service and the self-hosted Browserless in Docker, preventing a remote CDP websocket connection.

Guidance

  • Verify that the browserless service is correctly exposed on port 3000 within the Docker Compose network and that the ws://browserless:3000/?token=xxxx URL is correctly formatted.
  • Check the Browserless version (2.47.0) for any known issues with CDP websocket connections and consider updating to a newer version if available.
  • Investigate the OpenClaw browser profile configuration to ensure it is correctly set up for remote CDP connections, paying attention to the cdpUrl parameter.
  • Test the CDP websocket connection using a tool like wscat to verify that the issue is not specific to OpenClaw.

Example

No code snippet is provided as the issue seems to be related to configuration and compatibility rather than code.

Notes

The issue may be specific to the combination of OpenClaw version 2026.4.15 and Browserless version 2.47.0, and further investigation is needed to determine the root cause.

Recommendation

Apply a workaround by checking the Browserless version and updating it if necessary, as the issue seems to be related to a compatibility problem between OpenClaw and Browserless.

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…

FAQ

Expected behavior

OpenClaw should establish a remote CDP connection to Browserless and navigate normally.

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 [Bug]: Browser tool cannot connect to self-hosted Browserless remote CDP in Docker even though /json/version?token=... succeeds