--- read_when: Browser control fails on Linux, especially with snap Chromium summary: Perbaiki masalah saat memulai CDP Chrome/Brave/Edge/Chromium untuk kontrol browser OpenClaw di Linux title: Pemecahan masalah peramban x-i18n: generated_at: "2026-04-30T10:13:23Z" model: gpt-5.5 provider: openai source_hash: d9a91ea42a8a600163bcf66ad398677175bd0c5186d3e1dddb629a55c2ea66ed source_path: tools/browser-linux-troubleshooting.md workflow: 16 --- ## Masalah: "Gagal memulai Chrome CDP pada port 18800" Server kontrol browser OpenClaw gagal meluncurkan Chrome/Brave/Edge/Chromium dengan galat: ``` {"error":"Error: Failed to start Chrome CDP on port 18800 for profile \"openclaw\"."} ``` ### Akar penyebab Di Ubuntu (dan banyak distro Linux), instalasi Chromium bawaan adalah **paket snap**. Pembatasan AppArmor milik Snap mengganggu cara OpenClaw memunculkan dan memantau proses browser. Perintah `apt install chromium` memasang paket stub yang mengalihkan ke snap: ``` Note, selecting 'chromium-browser' instead of 'chromium' chromium-browser is already the newest version (2:1snap1-0ubuntu2). ``` Ini BUKAN browser sungguhan - hanya sebuah wrapper. Kegagalan peluncuran Linux umum lainnya: - `The profile appears to be in use by another Chromium process` berarti Chrome menemukan berkas kunci `Singleton*` usang di direktori profil terkelola. OpenClaw menghapus kunci tersebut dan mencoba sekali lagi ketika kunci menunjuk ke proses yang sudah mati atau host yang berbeda. - `Missing X server or $DISPLAY` berarti browser terlihat diminta secara eksplisit pada host tanpa sesi desktop. Secara default, profil lokal terkelola sekarang kembali ke mode headless di Linux ketika `DISPLAY` dan `WAYLAND_DISPLAY` sama-sama tidak disetel. Jika Anda menyetel `OPENCLAW_BROWSER_HEADLESS=0`, `browser.headless: false`, atau `browser.profiles..headless: false`, hapus override headed tersebut, setel `OPENCLAW_BROWSER_HEADLESS=1`, mulai `Xvfb`, jalankan `openclaw browser start --headless` untuk peluncuran terkelola sekali jalan, atau jalankan OpenClaw dalam sesi desktop sungguhan. ### Solusi 1: Pasang Google Chrome (Direkomendasikan) Pasang paket resmi Google Chrome `.deb`, yang tidak di-sandbox oleh snap: ```bash 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 ``` Lalu perbarui konfigurasi OpenClaw Anda (`~/.openclaw/openclaw.json`): ```json { "browser": { "enabled": true, "executablePath": "/usr/bin/google-chrome-stable", "headless": true, "noSandbox": true } } ``` ### Solusi 2: Gunakan Snap Chromium dengan Mode Hanya-Attach Jika Anda harus menggunakan snap Chromium, konfigurasikan OpenClaw untuk attach ke browser yang dimulai secara manual: 1. Perbarui konfigurasi: ```json { "browser": { "enabled": true, "attachOnly": true, "headless": true, "noSandbox": true } } ``` 2. Mulai Chromium secara manual: ```bash chromium-browser --headless --no-sandbox --disable-gpu \ --remote-debugging-port=18800 \ --user-data-dir=$HOME/.openclaw/browser/openclaw/user-data \ about:blank & ``` 3. Secara opsional, buat layanan pengguna systemd untuk memulai Chrome otomatis: ```ini # ~/.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 ``` Aktifkan dengan: `systemctl --user enable --now openclaw-browser.service` ### Memverifikasi Browser Berfungsi Periksa status: ```bash curl -s http://127.0.0.1:18791/ | jq '{running, pid, chosenBrowser}' ``` Uji penjelajahan: ```bash curl -s -X POST http://127.0.0.1:18791/start curl -s http://127.0.0.1:18791/tabs ``` ### Referensi konfigurasi | Opsi | Deskripsi | Bawaan | | -------------------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------- | | `browser.enabled` | Aktifkan kontrol browser | `true` | | `browser.executablePath` | Path ke biner browser berbasis Chromium (Chrome/Brave/Edge/Chromium) | terdeteksi otomatis (mengutamakan browser bawaan jika berbasis Chromium) | | `browser.headless` | Jalankan tanpa GUI | `false` | | `OPENCLAW_BROWSER_HEADLESS` | Override per proses untuk mode headless browser lokal terkelola | tidak disetel | | `browser.noSandbox` | Tambahkan flag `--no-sandbox` (diperlukan untuk sebagian setup Linux) | `false` | | `browser.attachOnly` | Jangan luncurkan browser, hanya attach ke yang sudah ada | `false` | | `browser.cdpPort` | Port Chrome DevTools Protocol | `18800` | | `browser.localLaunchTimeoutMs` | Timeout penemuan Chrome lokal terkelola | `15000` | | `browser.localCdpReadyTimeoutMs` | Timeout kesiapan CDP setelah peluncuran lokal terkelola | `8000` | Pada Raspberry Pi, host VPS lama, atau penyimpanan lambat, naikkan `browser.localLaunchTimeoutMs` ketika Chrome memerlukan lebih banyak waktu untuk mengekspos endpoint HTTP CDP-nya. Naikkan `browser.localCdpReadyTimeoutMs` ketika peluncuran berhasil tetapi `openclaw browser start` masih melaporkan `not reachable after start`. Nilai harus berupa bilangan bulat positif hingga `120000` ms; nilai konfigurasi yang tidak valid akan ditolak. ### Masalah: "Tidak ada tab Chrome yang ditemukan untuk profile=\"user\"" Anda menggunakan profil `existing-session` / Chrome MCP. OpenClaw dapat melihat Chrome lokal, tetapi tidak ada tab terbuka yang tersedia untuk di-attach. Opsi perbaikan: 1. **Gunakan browser terkelola:** `openclaw browser start --browser-profile openclaw` (atau setel `browser.defaultProfile: "openclaw"`). 2. **Gunakan Chrome MCP:** pastikan Chrome lokal berjalan dengan setidaknya satu tab terbuka, lalu coba lagi dengan `--browser-profile user`. Catatan: - `user` hanya untuk host lokal. Untuk server Linux, kontainer, atau host jarak jauh, utamakan profil CDP. - Profil `user` / `existing-session` lainnya mempertahankan batasan Chrome MCP saat ini: aksi berbasis ref, hook unggah satu berkas, tanpa override timeout dialog, tanpa `wait --load networkidle`, dan tanpa `responsebody`, ekspor PDF, intersepsi unduhan, atau aksi batch. - Profil `openclaw` lokal menetapkan otomatis `cdpPort`/`cdpUrl`; hanya setel itu untuk CDP jarak jauh. - Profil CDP jarak jauh menerima `http://`, `https://`, `ws://`, dan `wss://`. Gunakan HTTP(S) untuk penemuan `/json/version`, atau WS(S) ketika layanan browser Anda memberi URL soket DevTools langsung. ## Terkait - [Browser](/id/tools/browser) - [Login browser](/id/tools/browser-login) - [Pemecahan masalah Browser WSL2](/id/tools/browser-wsl2-windows-remote-cdp-troubleshooting)