From a623a1a3e507a648a041e09eb8e0ff23b8515a91 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Sat, 25 Apr 2026 05:24:00 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@a35333abe1641603fa148b5126e7afe8db642f09 --- .openclaw-sync/source.json | 4 ++-- docs/tools/browser-linux-troubleshooting.md | 10 ++++++++++ 2 files changed, 12 insertions(+), 2 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index 0362b4d17..8f136158e 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "f00d65a30496335fb068f01fe529dbba484d4312", - "syncedAt": "2026-04-25T05:19:53.736Z" + "sha": "a35333abe1641603fa148b5126e7afe8db642f09", + "syncedAt": "2026-04-25T05:22:43.223Z" } diff --git a/docs/tools/browser-linux-troubleshooting.md b/docs/tools/browser-linux-troubleshooting.md index b8df2b2f2..9362d937b 100644 --- a/docs/tools/browser-linux-troubleshooting.md +++ b/docs/tools/browser-linux-troubleshooting.md @@ -25,6 +25,16 @@ chromium-browser is already the newest version (2:1snap1-0ubuntu2). This is NOT a real browser - it's just a wrapper. +Other common Linux launch failures: + +- `The profile appears to be in use by another Chromium process` means Chrome + found stale `Singleton*` lock files in the managed profile directory. OpenClaw + removes those locks and retries once when the lock points at a dead or + different-host process. +- `Missing X server or $DISPLAY` means OpenClaw is trying to launch a visible + browser on a host without a desktop session. Use `browser.headless: true`, + start `Xvfb`, or run OpenClaw in a real desktop session. + ### Solution 1: Install Google Chrome (Recommended) Install the official Google Chrome `.deb` package, which is not sandboxed by snap: