Langsung ke konten utama

​
Pemecahan Masalah Browser (Linux)

​
Masalah: “Failed to start Chrome CDP on port 18800”

Server kontrol browser OpenClaw gagal meluncurkan Chrome/Brave/Edge/Chromium dengan pesan kesalahan: 
{"error":"Error: Failed to start Chrome CDP on port 18800 for profile "openclaw"."}

​
Penyebab Utama

Pada Ubuntu (dan banyak distro Linux lainnya), instalasi Chromium default adalah sebuah paket snap. Pembatasan (confinement) AppArmor dari Snap mengganggu cara OpenClaw memulai dan memantau proses browser. Perintah apt install chromium sebenarnya menginstal paket perantara yang mengarahkan ke snap. Ini bukanlah browser asli, melainkan hanya sebuah pembungkus (wrapper).

​
Solusi 1: Instal Google Chrome (Direkomendasikan)

Instal paket resmi Google Chrome .deb, yang tidak dibatasi oleh snap: 
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 ada kesalahan dependensi
Kemudian perbarui konfigurasi OpenClaw Anda (~/.openclaw/openclaw.json): 
{
  "browser": {
    "enabled": true,
    "executablePath": "/usr/bin/google-chrome-stable",
    "headless": true,
    "noSandbox": true
  }
}

​
Solusi 2: Gunakan Snap Chromium dengan Mode Attach-Only

Jika Anda harus menggunakan snap Chromium, konfigurasi OpenClaw untuk menempel (attach) pada browser yang dijalankan secara manual:
  1. Perbarui konfigurasi:
{
  "browser": {
    "enabled": true,
    "attachOnly": true,
    "noSandbox": true
  }
}
  1. Jalankan Chromium secara manual:
chromium-browser --headless --no-sandbox --disable-gpu \
  --remote-debugging-port=18800 \
  --user-data-dir=$HOME/.openclaw/browser/openclaw/user-data \
  about:blank &
  1. (Opsional) Buat layanan pengguna systemd untuk menjalankan Chrome secara otomatis.

​
Verifikasi Kerja Browser

Periksa status: 
curl -s http://127.0.0.1:18791/ | jq '{running, pid, chosenBrowser}'
Uji penjelajahan: 
curl -s -X POST http://127.0.0.1:18791/start
curl -s http://127.0.0.1:18791/tabs

​
Referensi Konfigurasi

OpsiDeskripsiDefault
browser.enabledMengaktifkan kontrol browsertrue
browser.executablePathJalur ke biner browser berbasis Chromiumdeteksi otomatis
browser.headlessJalankan tanpa antarmuka GUIfalse
browser.noSandboxTambahkan flag --no-sandboxfalse
browser.attachOnlyJangan luncurkan browser, hanya tempel ke yang sudah adafalse

​
Masalah: “Chrome extension relay is running, but no tab is connected”

Anda menggunakan profil chrome (relay ekstensi). Ini mengharuskan ekstensi browser OpenClaw menempel pada tab yang aktif. Solusi:
  1. Gunakan browser terkelola: openclaw browser start --browser-profile openclaw.
  2. Gunakan relay ekstensi: instal ekstensi, buka tab, dan klik ikon ekstensi OpenClaw untuk menghubungkannya.