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

​

問題: ポート 18800 で Chrome CDP を起動できない

{ "error": "エラー: プロファイル \"openclaw\" の Chrome CDP をポート 18800 で起動できませんでした。" }

​

根本原因

注: 'chromium' の代わりに 'chromium-browser' を選択しています
chromium-browser はすでに最新バージョン (2:1snap1-0ubuntu2) です。

• The profile appears to be in use by another Chromium process: 管理対象プロファイルディレクトリに古い Singleton* ロックファイルが残っています。ロックが終了済みまたは 別ホストのプロセスを指している場合、OpenClaw はこれらのロックを削除し、 1 回再試行します。
• 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 を起動するか、 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  # 依存関係エラーがある場合

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

​

解決策 2: snap Chromium をアタッチ専用モードで使用する

{
  "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 ブラウザ (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. ローカルの Chrome で少なくとも 1 つのタブを開いたままにしてから、 --browser-profile user で再試行します。

• user はホスト専用です。Linux サーバー、コンテナ、またはリモートホストでは、 代わりに CDP プロファイルを使用してください。
• user およびその他の existing-session プロファイルには、現在の Chrome MCP の制限が共通して適用されます。参照駆動型アクションのみ、アップロードごとに 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 トラブルシューティング