chore(sync): mirror docs from openclaw/openclaw@a35333abe1

.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"
 }

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: