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

OpenClaw hỗ trợ chạy trực tiếp trên môi trường Windows (native), nhưng để có trải nghiệm ổn định và trọn vẹn nhất với đầy đủ các tính năng như CLI, Gateway hay các công cụ đi kèm, nhà phát triển khuyến cáo nên sử dụng WSL2 (Windows Subsystem for Linux).

Tháng 4 8, 2026 - 09:08 Đã cập nhật: Tháng 4 8, 2026 - 09:37
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: Cài đặt môi trường cần thiết (Git, Node.js, pnpm)

Để build được mã nguồn OpenClaw, hệ thống Ubuntu của bạn cần có sẵn Git, Node.js và pnpm. Lần lượt chạy các lệnh sau trong terminal Ubuntu:

1. Cài đặt Git:

Bash 
sudo apt update
sudo apt install git -y

2. Cài đặt Node.js thông qua NVM (Node Version Manager): Sử dụng NVM sẽ giúp bạn quản lý phiên bản Node.js dễ dàng và tránh được các lỗi phân quyền khó chịu.

Bash 
# Tải và cài đặt NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Áp dụng cấu hình để nhận diện lệnh nvm
source ~/.bashrc

# Cài đặt Node.js phiên bản LTS mới nhất (ví dụ bản 22)
nvm install 22

3. Cài đặt pnpm: Sử dụng npm (đã có sẵn khi cài Node.js) để cài trình quản lý gói pnpm:

Bash 
npm install -g pnpm

Bạn có thể kiểm tra lại xem mọi thứ đã được cài đúng chưa bằng cách gõ git --version, node -v và pnpm -v.

Phần 3: 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ần lượt các lệnh sau:

Bash 
# Clone mã nguồn từ GitHub về máy
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Cài đặt các thư viện phụ thuộc
pnpm install

# Build giao diện UI (sẽ tự động cài dependencies UI ở lần chạy đầu)
pnpm ui:build

# Build toàn bộ dự án OpenClaw
pnpm build

# Khởi chạy thiết lập ban đầu
openclaw onboard

Phần 4: Thiết lập Gateway Service chạy ngầm

Để OpenClaw luôn sẵn sàng hoạt động ở chế độ nền phục vụ cho các tác vụ của bạn, hãy cài đặt Gateway. Trong terminal WSL, chạy một trong hai lệnh sau:

Bash 
openclaw onboard --install-daemon
# Hoặc:
openclaw gateway install

Khi màn hình xuất hiện thông báo, hãy chọn mục Gateway service.

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 5 (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.

Tags: