瀏覽器疑難排解

問題：無法在連接埠 18800 啟動 Chrome CDP

{ "error": "Error: Failed to start Chrome CDP on port 18800 for profile \"openclaw\"." }

根本原因

在 Ubuntu 和大多數 Linux 發行版上，apt install chromium 安裝的是 Snap 包裝程式，而不是真正的瀏覽器：

Note, selecting 'chromium-browser' instead of 'chromium'chromium-browser is already the newest version (2:1snap1-0ubuntu2).

Snap 的 AppArmor 限制會干擾 OpenClaw 啟動及監控瀏覽器程序的方式。

其他常見的 Linux 啟動失敗情況：

• The profile appears to be in use by another Chromium process：受管理設定檔目錄中有過時的 Singleton* 鎖定檔案。當鎖定指向已終止或位於不同主機上的程序時，OpenClaw 會移除 這些鎖定並重試一次。
• Missing X server or $DISPLAY：在沒有桌面工作階段的主機上，明確要求使用可見的瀏覽器。 在 Linux 上，如果 DISPLAY 和 WAYLAND_DISPLAY 都未設定，本機受管理設定檔會改用 無介面模式。如果你設定了 OPENCLAW_BROWSER_HEADLESS=0、browser.headless: false 或 browser.profiles.<name>.headless: false，請移除該有介面模式覆寫、設定 OPENCLAW_BROWSER_HEADLESS=1、啟動 Xvfb、執行 openclaw browser start --headless 進行一次性的受管理啟動，或在真正的桌面工作階段中執行 OpenClaw。

解決方案 1：安裝 Google Chrome（建議）

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.debsudo dpkg -i google-chrome-stable_current_amd64.debsudo apt --fix-broken install -y  # 如果發生相依性錯誤

更新 ~/.openclaw/openclaw.json：

{  "browser": {    "enabled": true,    "executablePath": "/usr/bin/google-chrome-stable",    "headless": true,    "noSandbox": true  }}

解決方案 2：以僅附加模式使用 Snap Chromium

如果必須保留 Snap Chromium，請將 OpenClaw 設定為附加至手動啟動的瀏覽器，而不是自行啟動：

{  "browser": {    "enabled": true,    "attachOnly": true,    "headless": true,    "noSandbox": true  }}

手動啟動 Chromium：

chromium-browser --headless --no-sandbox --disable-gpu \  --remote-debugging-port=18800 \  --user-data-dir=$HOME/.openclaw/browser/openclaw/user-data \  about:blank &

也可以選擇透過 systemd 使用者服務自動啟動：

# ~/.config/systemd/user/openclaw-browser.service[Unit]Description=OpenClaw Browser (Chrome CDP)After=network.target [Service]ExecStart=/snap/bin/chromium --headless --no-sandbox --disable-gpu --remote-debugging-port=18800 --user-data-dir=%h/.openclaw/browser/openclaw/user-data about:blankRestart=on-failureRestartSec=5 [Install]WantedBy=default.target

systemctl --user enable --now openclaw-browser.service

驗證瀏覽器是否正常運作

curl -s http://127.0.0.1:18791/ | jq '{running, pid, chosenBrowser}'curl -s -X POST http://127.0.0.1:18791/startcurl -s http://127.0.0.1:18791/tabs

設定參考

兩個逾時值都必須是最大不超過 120000 毫秒的正整數；其他值會在載入設定時遭到拒絕。 在 Raspberry Pi、較舊的 VPS 主機或速度較慢的儲存裝置上，如果 Chrome 需要更多時間才能公開其 CDP HTTP 端點，請提高 browser.localLaunchTimeoutMs。如果啟動成功，但 openclaw browser start 仍回報 not reachable after start，請提高 browser.localCdpReadyTimeoutMs。

問題：找不到 profile="user" 的 Chrome 分頁

你正在使用 user（existing-session / Chrome MCP）設定檔，但沒有可供附加的已開啟分頁。

修正方式：

1. 改用受管理瀏覽器： openclaw browser --browser-profile openclaw start（或設定 browser.defaultProfile: "openclaw"）。
2. 保持本機 Chrome 執行且至少開啟一個分頁，然後使用 --browser-profile user 重試。

注意事項：

• user 僅適用於主機。在 Linux 伺服器、容器或遠端主機上，請改用 CDP 設定檔。
• user 和其他 existing-session 設定檔共用目前的 Chrome MCP 限制：僅支援以參照為基礎的操作、每次上傳一個檔案、不支援對話方塊 timeoutMs 覆寫、不支援 wait --load networkidle，也不支援 responsebody、PDF 匯出、 下載攔截或批次操作。
• 本機 openclaw 驅動程式設定檔會自動指派 cdpPort/cdpUrl；只有遠端 CDP 才需要手動設定這些值。
• 遠端 CDP 設定檔接受 http://、https://、ws:// 和 wss://。 使用 HTTP(S) 進行 /json/version 探索；如果瀏覽器服務提供直接的 DevTools 通訊端 URL，則使用 WS(S)。

相關內容

• 瀏覽器
• 瀏覽器登入
• 瀏覽器 WSL2 疑難排解