Xử lý sự cố trình duyệt (Linux)¶

Vấn đề: "Failed to start Chrome CDP on port 18800"¶

Máy chủ điều khiển trình duyệt của OpenClaw không thể khởi chạy Chrome/Brave/Edge/Chromium với lỗi:

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

Nguyên nhân gốc rễ¶

34. Trên Ubuntu (và nhiều distro Linux), cài đặt Chromium mặc định là gói snap. Snap's AppArmor confinement interferes with how OpenClaw spawns and monitors the browser process.

Lệnh apt install chromium cài đặt một gói stub chuyển hướng sang snap:

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

Đây KHÔNG phải là một trình duyệt thực — chỉ là một wrapper.

Giải pháp 1: Cài đặt Google Chrome (Khuyến nghị)¶

Cài đặt gói Google Chrome chính thức .deb, không bị sandbox bởi 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  # if there are dependency errors

Sau đó cập nhật cấu hình OpenClaw của bạn (~/.openclaw/openclaw.json):

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

Giải pháp 2: Dùng Chromium snap với chế độ Chỉ-gắn (Attach-Only)¶

Nếu buộc phải dùng Chromium dạng snap, hãy cấu hình OpenClaw để gắn vào một trình duyệt được khởi chạy thủ công:

1. Cập nhật cấu hình:

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

2. Khởi động Chromium thủ công:

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

3. (Tùy chọn) Tạo dịch vụ systemd cho người dùng để tự động khởi động Chrome:

# ~/.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

Kích hoạt bằng: systemctl --user enable --now openclaw-browser.service

Xác minh trình duyệt hoạt động¶

Kiểm tra trạng thái:

curl -s http://127.0.0.1:18791/ | jq '{running, pid, chosenBrowser}'

Thử duyệt web:

curl -s -X POST http://127.0.0.1:18791/start
curl -s http://127.0.0.1:18791/tabs

Tham chiếu cấu hình¶

Vấn đề: "Chrome extension relay is running, but no tab is connected"¶

Bạn đang sử dụng hồ sơ chrome (extension relay). Hồ sơ này yêu cầu OpenClaw browser extension to be attached to a live tab.

Các cách khắc phục:

1. Dùng trình duyệt được quản lý: openclaw browser start --browser-profile openclaw (hoặc đặt browser.defaultProfile: "openclaw").
2. Dùng extension relay: cài tiện ích mở rộng, mở một tab và nhấp vào biểu tượng tiện ích OpenClaw để gắn.

Ghi chú:

• Profile chrome sử dụng trình duyệt Chromium mặc định của hệ thống khi có thể.
• Các profile openclaw cục bộ tự động gán cdpPort/cdpUrl; chỉ đặt các giá trị đó cho CDP từ xa.