Cách cài đặt OpenClaw trên máy tính Windows: Chính xác và mới nhất 2026!

Để đảm bảo tính chính xác của bài viết, các thông tin mình sử dụng được tham khảo từ trang chính thống của openclaw tại: https://docs.openclaw.ai/platforms/windows

Trong bài viết này, tôi sẽ hướng dẫn bạn chi tiết từng bước từ con số 0 để thiết lập và chạy OpenClaw mượt mà trên hệ điều hành Windows thông qua WSL2.

Phần 1: Cài đặt và cấu hình WSL2

Bước 1: Cài đặt WSL2 và Ubuntu

1. Nhấn chuột phải vào menu Start, chọn Windows PowerShell (Admin) hoặc Terminal (Admin).

2. Chạy lệnh sau để hệ thống tự động cài đặt WSL và bản phân phối mặc định (Ubuntu):

   PowerShell

   wsl --install
   

   (Tùy chọn: Nếu bạn muốn cài đích danh bản Ubuntu 24.04, hãy dùng lệnh wsl --install -d Ubuntu-24.04).

3. Sau khi chạy xong, hãy khởi động lại máy tính nếu Windows yêu cầu.

Bước 2: Kích hoạt systemd (Bắt buộc) OpenClaw Gateway cần systemd để chạy ngầm. Mặc định trên WSL tính năng này chưa được bật.

1. Mở ứng dụng Ubuntu (hoặc terminal WSL) từ menu Start.

2. Chạy lệnh sau để cấu hình bật systemd:

   Bash

   sudo tee /etc/wsl.conf >/dev/null <<'EOF'
   [boot]
   systemd=true
   EOF
   

3. Đóng cửa sổ Ubuntu. Mở lại PowerShell (Admin) trên Windows và tắt WSL hoàn toàn để áp dụng thay đổi:

   PowerShell

   wsl --shutdown
   

4. Mở lại Ubuntu và chạy lệnh sau để kiểm tra xem systemd đã hoạt động chưa (nếu không báo lỗi là thành công):

   Bash

   systemctl --user status
   

Phần 2: Tải mã nguồn và Build OpenClaw

Sau khi môi trường đã sẵn sàng, chúng ta tiến hành tải và cài đặt OpenClaw. Vẫn trong terminal Ubuntu, bạn thực thi lệnh sau:

curl -fsSL https://openclaw.ai/install.sh | bash

Sau khi chạy xong nếu OpenClaw Doctor xuất hiện, được hỏi gì bạn cứ bấm Yes.

Chạy xong OpenClaw Doctor sẽ xuất hiện một link web dạng http://127.0.0.1 kèm token, copy nguyên cả dòng này và dán vào trình duyệt (lưu ý nó sẽ chưa chạy luôn)

Tiếp tục quay lại terminal Ubuntu và gõ lệnh:

openclaw onboard

Tiến hành chọn yes và làm theo chỉ dẫn để kích hoạt OpenClaw. Ở bước chọn nhà cung cấp AI bạn chỉ cần chọn model bạn sử dụng, rồi nhập token để kết nối.

Channel là để chọn kênh kết nối như Zalo hay Telegram, nếu bạn muốn kết nối luôn thì có thể sử dụng, còn không có thể bỏ qua

Tới Skill thì cứ tích vào skip (bấm phím cách ở ô skip) rồi bấm enter để bỏ qua

Thêm một vài bước bấm yes nữa là bạn sẽ thấy hệ thống báo OpenClaw đã kích hoạt thành công. Lúc này quay lại làm mới trang web 127.0.0.1 lúc trước, bạn sẽ thấy giao diện OpenClaw hiện ra và sẵn sàng hoạt động

Mẹo: Bất cứ khi nào OpenClaw gặp trục trặc, bạn có thể gõ lệnh openclaw doctor để hệ thống tự động kiểm tra và sửa lỗi.

Phần 3 (Nâng cao): Cấu hình truy cập từ mạng LAN & Tự động chạy

Phần này dành cho những bạn dùng máy tính Windows làm server chạy 24/7 (Headless) hoặc muốn thiết bị khác trong cùng mạng WiFi truy cập được vào OpenClaw đang chạy trong WSL.

1. Tự động chạy WSL và Gateway khi mở máy (Không cần đăng nhập Windows)

• Trong Ubuntu, bật quyền cho phép service chạy khi chưa đăng nhập:

  Bash

  sudo loginctl enable-linger "$(whoami)"
  openclaw gateway install
  

• Mở PowerShell (Admin) trên Windows để tạo một Scheduled Task tự khởi động WSL:

  PowerShell

  schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec /bin/true" /sc onstart /ru SYSTEM
  

  (Lưu ý: Thay chữ Ubuntu bằng tên bản phân phối thực tế của bạn, xem tên bằng lệnh wsl --list --verbose).

2. Forward Port (Portproxy) để truy cập qua mạng LAN WSL dùng một dải mạng ảo riêng, tách biệt với Windows. Do đó, bạn phải "đục lỗ" (forward port) từ Windows vào WSL.

• Mở PowerShell (Admin) và chạy đoạn mã sau (Ví dụ forward cổng 2222 của Windows vào cổng 22 của WSL):

  PowerShell

  $Distro = "Ubuntu" # Đổi thành tên distro của bạn, ví dụ: Ubuntu-24.04
  $ListenPort = 2222
  $TargetPort = 22
  
  $WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]
  if (-not $WslIp) { throw "WSL IP not found." }
  
  netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort connectaddress=$WslIp connectport=$TargetPort
  

• Mở khóa tường lửa trên Windows (Chỉ cần chạy 1 lần duy nhất):

  PowerShell

  New-NetFirewallRule -DisplayName "WSL Port $ListenPort" -Direction Inbound -Protocol TCP -LocalPort $ListenPort -Action Allow
  

Lưu ý quan trọng: IP của WSL sẽ thay đổi mỗi khi bạn khởi động lại máy tính. Vì vậy, lệnh cấu hình $WslIp và netsh interface portproxy ở trên cần được chạy lại sau mỗi lần reboot (bạn có thể đưa nó vào một script tự chạy của Windows). Khi kết nối từ thiết bị khác, hãy dùng IP mạng LAN của máy Windows.