Pemecahan masalah browser

​

Masalah: Gagal memulai Chrome CDP pada port 18800

{ "error": "Kesalahan: Gagal memulai Chrome CDP pada port 18800 untuk profil \"openclaw\"." }

​

Penyebab utama

Catatan, memilih 'chromium-browser' alih-alih 'chromium'
chromium-browser sudah merupakan versi terbaru (2:1snap1-0ubuntu2).

• The profile appears to be in use by another Chromium process: file kunci Singleton* yang kedaluwarsa di direktori profil terkelola. OpenClaw menghapus kunci ini dan mencoba kembali satu kali saat kunci tersebut menunjuk ke proses yang sudah mati atau berada di host lain.
• Missing X server or $DISPLAY: peramban yang terlihat diminta secara eksplisit pada host tanpa sesi desktop. Profil lokal terkelola beralih ke mode headless di Linux saat DISPLAY dan WAYLAND_DISPLAY tidak disetel. Jika Anda menyetel OPENCLAW_BROWSER_HEADLESS=0, browser.headless: false, atau browser.profiles.<name>.headless: false, hapus penggantian mode headed tersebut, setel OPENCLAW_BROWSER_HEADLESS=1, mulai Xvfb, jalankan openclaw browser start --headless untuk peluncuran terkelola satu kali, atau jalankan OpenClaw dalam sesi desktop sebenarnya.

​

Solusi 1: instal Google Chrome (disarankan)

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  # jika terdapat kesalahan dependensi

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

​

Solusi 2: gunakan Chromium snap dalam mode hanya-lampirkan

{
  "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=Peramban 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

​

Verifikasi bahwa peramban berfungsi

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

​

Referensi konfigurasi

​

Masalah: Tidak ditemukan tab Chrome untuk profile=“user”

1. Gunakan peramban terkelola sebagai gantinya: openclaw browser --browser-profile openclaw start (atau setel browser.defaultProfile: "openclaw").
2. Biarkan Chrome lokal tetap berjalan dengan setidaknya satu tab terbuka, lalu coba lagi dengan --browser-profile user.

• user hanya untuk host. Pada server Linux, kontainer, atau host jarak jauh, sebaiknya gunakan profil CDP.
• user dan profil existing-session lainnya memiliki batasan Chrome MCP saat ini yang sama: hanya tindakan berbasis ref, satu file per unggahan, tanpa penggantian timeoutMs dialog, tanpa wait --load networkidle, serta tanpa responsebody, ekspor PDF, intersepsi unduhan, atau tindakan batch.
• Profil driver openclaw lokal menetapkan cdpPort/cdpUrl secara otomatis; hanya setel keduanya secara manual untuk CDP jarak jauh.
• Profil CDP jarak jauh menerima http://, https://, ws://, dan wss://. Gunakan HTTP(S) untuk penemuan /json/version, atau WS(S) saat layanan peramban Anda memberikan URL soket DevTools langsung.

​

Terkait

• Peramban
• Login peramban
• Pemecahan masalah WSL2 peramban