ブラウザーのトラブルシューティング

​

問題: ポート 18800 で Chrome CDP の起動に失敗する

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

​

根本原因

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

• The profile appears to be in use by another Chromium process: 管理対象プロファイルディレクトリ内の古い Singleton* ロックファイル。OpenClaw は、ロックが停止済みまたは 別ホストのプロセスを指している場合、これらのロックを削除して一度だけ再試行します。
• Missing X server or $DISPLAY: デスクトップセッションのないホストで、表示可能なブラウザが明示的に要求されています。ローカル管理対象プロファイルは、 DISPLAY と WAYLAND_DISPLAY の両方が未設定の場合、Linux ではヘッドレスモードにフォールバックします。 OPENCLAW_BROWSER_HEADLESS=0、browser.headless: false、または browser.profiles.<name>.headless: false を設定している場合は、その headed override を削除するか、 OPENCLAW_BROWSER_HEADLESS=1 を設定するか、Xvfb を起動するか、 1 回限りの管理対象起動として openclaw browser start --headless を実行するか、実際のデスクトップセッションで OpenClaw を実行してください。

​

解決策 1: Google Chrome をインストールする（推奨）

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt --fix-broken install -y  # if there are dependency errors

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

​

解決策 2: snap Chromium を attach-only モードで使用する

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

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

# ~/.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:blank
Restart=on-failure
RestartSec=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/start
curl -s http://127.0.0.1:18791/tabs

​

設定リファレンス

​

問題: profile=“user” の Chrome タブが見つからない

1. 代わりに管理対象ブラウザを使用します: openclaw browser --browser-profile openclaw start（または browser.defaultProfile: "openclaw" を設定します）。
2. 少なくとも 1 つのタブを開いた状態でローカル Chrome を実行し続け、その後 --browser-profile user で再試行します。

• user はホスト専用です。Linux サーバー、コンテナ、またはリモートホストでは、代わりに CDP プロファイルを推奨します。
• user とその他の existing-session プロファイルは、現在の Chrome MCP の制限を共有します: ref 駆動のアクションのみ、アップロードは 1 ファイルずつ、ダイアログの timeoutMs 上書きなし、wait --load networkidle なし、そして responsebody、PDF エクスポート、 ダウンロードインターセプト、バッチアクションなし。
• ローカルの openclaw ドライバープロファイルは cdpPort/cdpUrl を自動割り当てします。これらは リモート CDP の場合にのみ手動設定してください。
• リモート CDP プロファイルは http://、https://、ws://、wss:// を受け入れます。 /json/version 検出には HTTP(S) を使用し、ブラウザサービスが直接の DevTools ソケット URL を提供する場合は WS(S) を使用してください。

​

関連

• ブラウザ
• ブラウザログイン
• ブラウザ WSL2 トラブルシューティング