Khắc phục sự cố WSL2 + Windows + Chrome CDP từ xa

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.

​

Chọn đúng chế độ trình duyệt trước

​

Tùy chọn 1: CDP từ xa thô từ WSL2 đến Windows

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

​

Tùy chọn 2: Chrome MCP cục bộ trên máy chủ

• OpenClaw và Chrome ở trên cùng một máy
• bạn muốn trạng thái trình duyệt cục bộ đã đăng nhập
• bạn không cần truyền tải trình duyệt xuyên máy chủ
• bạn không cần các tuyến nâng cao chỉ dành cho quản lý/CDP thô như responsebody, xuất PDF, chặn tải xuống, hoặc hành động hàng loạt

​

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 phơi bày một điểm cuối CDP trên cổng 9222
• WSL2 có thể truy cập điểm cuối Windows CDP đó
• OpenClaw trỏ một hồ sơ trình duyệt đến địa chỉ có thể truy cập từ WSL2

​

Vì sao thiết lập này dễ gây nhầm lẫn

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

​

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 điểm cuối Windows đó

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

• /json/version trả về JSON có siêu dữ liệu Browser / Protocol-Version
• /json/list trả về JSON (mảng rỗng cũng được nếu không có trang nào đang mở)

• Windows chưa phơi bày cổng cho WSL2
• địa chỉ sai ở phía WSL2
• tường lửa / chuyển tiếp cổng / proxy cục bộ vẫn còn thiếu

​

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

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

• 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 các trình duyệt được quản lý bên ngoài
• cdpUrl có thể là http://, https://, ws://, hoặc wss://
• dùng HTTP(S) khi bạn muốn OpenClaw khám phá /json/version
• chỉ dùng WS(S) khi nhà cung cấp trình duyệt cung cấp cho bạn URL socket DevTools trực tiếp
• kiểm tra cùng URL đó bằng curl trước khi kỳ vọng OpenClaw thành công

​

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

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

• Giao diện Điều khiển

​

Lớp 5: Xác minh điều khiển trình duyệt đầu-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ề đích
• các hành động sau đó (snapshot, screenshot, navigate) hoạt động từ cùng hồ sơ

​

Các lỗi dễ gây hiểu nhầm thường gặp

• control-ui-insecure-auth
  • vấn đề nguồn gốc UI / ngữ cảnh an toàn, không phải vấn đề truyền tải 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
• Browser attachOnly is enabled and CDP websocket for profile "remote" is not reachable
  • điểm cuối HTTP đã phản hồi, nhưng DevTools WebSocket vẫn không thể được mở
• ghi đè khung nhìn / chế độ tối / ngôn ngữ / ngoại tuyến cũ sau một phiên từ xa
  • chạy openclaw browser stop --browser-profile remote
  • thao tác này đóng phiên điều khiển đang hoạt động và giải phóng trạng thái mô phỏng Playwright/CDP mà không khởi động lại gateway hoặc trình duyệt bên ngoài
• gateway timeout after 1500ms
  • thường vẫn là khả năng truy cập CDP hoặc điểm cuối từ xa chậm/không truy cập được
• No Chrome tabs found for profile="user"
  • hồ sơ Chrome MCP cục bộ được chọn khi không có tab cục bộ trên máy chủ nào khả dụng

​

Danh sách kiểm tra phân loại 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ó dùng đúng địa chỉ có thể truy cập từ WSL2 đó không?
4. Giao diện Điều khiển: bạn có đang mở http://127.0.0.1:18789/ thay vì IP LAN không?
5. Bạn có đang cố dùng existing-session xuyên WSL2 và Windows thay vì CDP từ xa thô không?

​

Kết luận thực tế

• xác minh cục bộ điểm cuối Windows Chrome trước
• xác minh cùng điểm cuối đó từ WSL2 sau
• 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

​

Liên quan

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