Documentation Index

Fetch the complete documentation index at: https://openclawhub.vn/llms.txt

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

​

Khắc phục sự cố WSL2 + Windows + remote Chrome CDP

• OpenClaw Gateway chạy trong WSL2
• Chrome chạy trên Windows
• điều khiển trình duyệt phải vượt qua ranh giới WSL2/Windows

​

Chọn chế độ trình duyệt phù hợp trước

​

Lựa chọn 1: Remote CDP thô từ WSL2 đến Windows

• Gateway nằm trong WSL2
• Chrome chạy trên Windows
• cần điều khiển trình duyệt vượt qua ranh giới WSL2/Windows

​

Lựa chọn 2: Host-local Chrome MCP

• OpenClaw và Chrome trên cùng một máy
• muốn trạng thái trình duyệt đã đăng nhập cục bộ
• không cần truyền trình duyệt qua host

​

Kiến trúc hoạt động

• WSL2 chạy Gateway trên 127.0.0.1:18789
• Windows mở Giao diện Điều khiển trong trình duyệt thông thường tại http://127.0.0.1:18789/
• Windows Chrome mở một endpoint CDP trên cổng 9222
• WSL2 có thể truy cập endpoint CDP của Windows
• OpenClaw trỏ một hồ sơ trình duyệt đến địa chỉ có thể truy cập từ WSL2

​

Tại sao cấu hình này gây nhầm lẫn

• WSL2 không thể truy cập endpoint CDP của Windows
• Giao diện Điều khiển được mở từ một nguồn không an toàn
• gateway.controlUi.allowedOrigins không khớp với nguồn trang
• thiếu token hoặc ghép đôi
• hồ sơ trình duyệt trỏ đến địa chỉ sai

​

Quy tắc quan trọng cho Giao diện Điều khiển

​

Xác thực theo từng lớp

​

Lớp 1: Xác minh Chrome đang phục vụ CDP trên Windows

chrome.exe --remote-debugging-port=9222

curl http://127.0.0.1:9222/json/version
curl http://127.0.0.1:9222/json/list

​

Lớp 2: Xác minh WSL2 có thể truy cập endpoint của Windows

curl http://WINDOWS_HOST_OR_IP:9222/json/version
curl http://WINDOWS_HOST_OR_IP:9222/json/list

• /json/version trả về JSON với metadata Browser / Protocol-Version
• /json/list trả về JSON (mảng rỗng cũng được nếu không có trang nào mở)

• Windows chưa mở cổng cho WSL2
• địa chỉ sai cho phía WSL2
• firewall / chuyển tiếp cổng / proxy cục bộ vẫn thiếu

​

Lớp 3: Cấu hình hồ sơ trình duyệt đúng

{
  browser: {
    enabled: true,
    defaultProfile: "remote",
    profiles: {
      remote: {
        cdpUrl: "http://WINDOWS_HOST_OR_IP:9222",
        attachOnly: true,
        color: "#00AA00",
      },
    },
  },
}

• sử dụng địa chỉ có thể truy cập từ WSL2, không phải địa chỉ chỉ hoạt động trên Windows
• giữ attachOnly: true cho trình duyệt được quản lý bên ngoài
• kiểm tra cùng URL với curl trước khi mong đợi OpenClaw thành công

​

Lớp 4: Xác minh lớp Giao diện Điều khiển riêng biệt

• nguồn trang khớp với những gì gateway.controlUi.allowedOrigins mong đợi
• xác thực token hoặc ghép đôi được cấu hình đúng
• không gỡ lỗi vấn đề xác thực Giao diện Điều khiển như thể đó là vấn đề trình duyệt

• Control UI

​

Lớp 5: Xác minh điều khiển trình duyệt từ đầu đến cuối

openclaw browser open https://example.com --browser-profile remote
openclaw browser tabs --browser-profile remote

• tab mở trong Windows Chrome
• openclaw browser tabs trả về mục tiêu
• các hành động sau (snapshot, screenshot, navigate) hoạt động từ cùng hồ sơ

​

Lỗi gây hiểu lầm phổ biến

• control-ui-insecure-auth
  • vấn đề nguồn UI / ngữ cảnh an toàn, không phải vấn đề truyền CDP
• token_missing
  • vấn đề cấu hình xác thực
• pairing required
  • vấn đề phê duyệt thiết bị
• Remote CDP for profile "remote" is not reachable
  • WSL2 không thể truy cập cdpUrl đã cấu hình
• gateway timeout after 1500ms
  • thường vẫn là vấn đề truy cập CDP hoặc endpoint từ xa chậm/không thể truy cập
• No Chrome tabs found for profile="user"
  • hồ sơ Chrome MCP cục bộ được chọn khi không có tab host-local nào có sẵn

​

Danh sách kiểm tra nhanh

1. Windows: curl http://127.0.0.1:9222/json/version có hoạt động không?
2. WSL2: curl http://WINDOWS_HOST_OR_IP:9222/json/version có hoạt động không?
3. Cấu hình OpenClaw: browser.profiles.<name>.cdpUrl có sử dụng địa chỉ chính xác có thể truy cập từ WSL2 không?
4. Giao diện Điều khiển: bạn có mở http://127.0.0.1:18789/ thay vì IP LAN không?
5. Bạn có đang cố sử dụng existing-session giữa WSL2 và Windows thay vì remote CDP thô không?

​

Kết luận thực tiễn

• xác minh endpoint Chrome trên Windows trước
• xác minh cùng endpoint từ WSL2 thứ hai
• chỉ sau đó mới gỡ lỗi cấu hình OpenClaw hoặc xác thực Giao diện Điều khiển