Khắc phục sự cố trình duyệt

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Sự cố: “Failed to start Chrome CDP on port 18800”

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

​

Nguyên nhân gốc

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

• The profile appears to be in use by another Chromium process nghĩa là Chrome tìm thấy các tệp khóa Singleton* cũ trong thư mục hồ sơ được quản lý. OpenClaw xóa các khóa đó và thử lại một lần khi khóa trỏ tới một tiến trình đã chết hoặc tiến trình trên máy chủ khác.
• Missing X server or $DISPLAY nghĩa là một trình duyệt hiển thị đã được yêu cầu rõ ràng trên máy chủ không có phiên desktop. Theo mặc định, các hồ sơ được quản lý cục bộ hiện chuyển về chế độ headless trên Linux khi cả DISPLAY và WAYLAND_DISPLAY đều chưa được đặt. Nếu bạn đặt OPENCLAW_BROWSER_HEADLESS=0, browser.headless: false, hoặc browser.profiles.<name>.headless: false, hãy xóa ghi đè headed đó, đặt OPENCLAW_BROWSER_HEADLESS=1, khởi động Xvfb, chạy openclaw browser start --headless cho một lần khởi chạy được quản lý, hoặc chạy OpenClaw trong một phiên desktop thật.

​

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

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

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

​

Giải pháp 2: Dùng Snap Chromium với chế độ Chỉ đính kèm

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 một dịch vụ systemd 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

​

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

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

​

Tham chiếu cấu hình

​

Sự cố: “No Chrome tabs found for profile=“user""

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 Chrome MCP: bảo đảm Chrome cục bộ đang chạy với ít nhất một tab đang mở, rồi thử lại với --browser-profile user.

• user chỉ dành cho máy chủ cục bộ. Với máy chủ Linux, container, hoặc máy chủ từ xa, nên dùng hồ sơ CDP.
• user / các hồ sơ existing-session khác giữ các giới hạn Chrome MCP hiện tại: hành động dựa trên ref, hook tải lên một tệp, không có ghi đè thời gian chờ hộp thoại, không có wait --load networkidle, và không có responsebody, xuất PDF, chặn tải xuống, hoặc hành động hàng loạt.
• Các hồ sơ openclaw cục bộ tự động gán cdpPort/cdpUrl; chỉ đặt các giá trị đó cho CDP từ xa.
• Hồ sơ CDP từ xa chấp nhận http://, https://, ws://, và wss://. Dùng HTTP(S) cho phát hiện /json/version, hoặc WS(S) khi dịch vụ trình duyệt của bạn cung cấp URL socket DevTools trực tiếp.

​

Liên quan

• Trình duyệt
• Đăng nhập trình duyệt
• Khắc phục sự cố Browser WSL2