Cài OpenClaw Trên Windows: 2 Cách Từ đơn Giản đến Nâng Cao (2026)

Cài OpenClaw trên Windows có hai hướng đi, tùy trình độ và nhu cầu của bạn:

Cách 1 — Native Windows (không cần WSL): Cài Node.js + Git trực tiếp trên Windows, tải source code từ GitHub, build và chạy. Đây là cách đơn giản nhất, phù hợp cho người muốn nhanh chóng dùng thử OpenClaw mà không cần biết gì về Linux.

Cách 2 — Qua WSL2 (khuyến nghị chính thức): Cài một lớp Linux nhẹ bên trong Windows, rồi cài OpenClaw giống hệt trên Mac/Linux. Đây là cách được team OpenClaw khuyến nghị vì tương thích tốt nhất — daemon tự chạy nền, hỗ trợ đầy đủ tính năng, và các hướng dẫn trong cộng đồng đều viết cho môi trường này.

Chưa biết OpenClaw cài bằng cách nào? Bài Hướng dẫn cài đặt OpenClaw từ A-Z giới thiệu tổng quan 4 phương pháp. Bài này tập trung vào 2 cách tối ưu nhất cho Windows.

Nên chọn cách nào?

Tiêu chí	Cách 1: Native Windows	Cách 2: WSL2
Độ khó	Dễ — chỉ cài phần mềm Windows quen thuộc	Trung bình — cần cài WSL2 (lần đầu hơi lạ)
Thời gian	~15-20 phút	~25-35 phút (bao gồm restart)
Daemon chạy nền	Không — phải mở Git Bash thủ công mỗi lần	Có — systemd service tự khởi động
Tương thích cộng đồng	Hạn chế — một số script/plugin có thể không hoạt động	Đầy đủ — giống Linux/Mac
Cần kiến thức Linux	Không	Cơ bản (chỉ gõ lệnh copy-paste)
Khuyến nghị cho	Người mới muốn thử nhanh, hoặc máy không hỗ trợ Virtualization	Người dùng lâu dài, cần OpenClaw chạy 24/7

Gợi ý: Nếu chỉ muốn dùng thử OpenClaw xem nó làm được gì → Cách 1. Nếu muốn deploy dùng thật, kết nối nhiều channel, chạy liên tục → Cách 2.

Yêu cầu chung trước khi bắt đầu

Thành phần	Yêu cầu	Cách kiểm tra
Windows	Windows 10 (build 19041+) hoặc Windows 11	Settings → System → About → OS Build
RAM	Tối thiểu 4 GB, khuyến nghị 8 GB+	Task Manager → Performance → Memory
Ổ cứng	4 GB trống (Cách 1) hoặc 10 GB trống (Cách 2, cần thêm WSL)	File Explorer → This PC
Virtualization	Chỉ cần cho Cách 2 (WSL2)	Task Manager → Performance → CPU → Virtualization: Enabled

Cách 1: Cài native trên Windows (không cần WSL)

Cách này cài OpenClaw trực tiếp trên Windows — bạn sẽ dùng cmd và Git Bash, không cần cài bất kỳ thứ gì liên quan đến Linux.

Bước 1.1: Cài Node.js

Bạn đang làm gì: Cài Node.js — nền tảng runtime mà OpenClaw chạy trên đó. Không có Node.js, OpenClaw không thể hoạt động.

Truy cập nodejs.org → nhấn “Get Node.js” → chọn phiên bản có chữ (LTS) → nhấn Windows Installer.

Mở file .msi vừa tải → nhấn Next liên tục cho đến khi xong → nhấn Finish.

Cách biết thành công: Mở cmd (gõ cmd trong Start menu → Enter) và chạy:

node -v

Nếu hiện v22.x.x hoặc v24.x.x → Node.js đã cài thành công. OpenClaw yêu cầu Node.js 22 trở lên.

Kiểm tra thêm npm (trình quản lý package, cài kèm với Node.js):

npm -v

Hiện số phiên bản → OK.

Bước 1.2: Cài pnpm

Bạn đang làm gì: Cài pnpm — trình quản lý package mà OpenClaw dùng để cài thư viện và build. Bạn vừa cài npm ở Bước 1.1 — dùng npm để cài pnpm.

Mở cmd với quyền Administrator:

Nhấn phím Windows
Gõ cmd
Khi thấy “Command Prompt” hiện trong kết quả → nhấn chuột phải → chọn “Run as administrator”
Windows hỏi “Do you want to allow…” → chọn Yes

Trong cửa sổ cmd vừa mở, gõ:

npm install -g pnpm

Nhấn Enter, đợi vài giây cho đến khi thấy dòng added 1 package hoặc tương tự.

Cách biết thành công: Gõ tiếp lệnh sau rồi nhấn Enter:

pnpm -v

Hiện số phiên bản (ví dụ 10.32.1) → pnpm đã cài thành công.

Bước 1.3: Cài Git

Bạn đang làm gì: Cài Git — công cụ quản lý mã nguồn. Bạn cần Git vì (1) sẽ dùng Git Bash để chạy một số lệnh, và (2) cần thiết cho quá trình build OpenClaw.

Truy cập git-scm.com → nhấn “Install for Windows” → chọn Git for Windows / x64 setup → tải file .exe về.

Mở file cài đặt → Windows hỏi “Do you want to allow this app to make changes?” → chọn Yes → nhấn Next cho đến bước cuối → tick “Launch Git Bash”, bỏ tick “View Release Notes” → nhấn Finish.

Git Bash sẽ tự mở — đây là terminal bạn sẽ dùng để chạy OpenClaw ở các bước sau.

Cách biết thành công: Trong Git Bash (hoặc cmd), gõ:

git --version

Hiện git version 2.x.x → Git đã cài thành công.

Bước 1.4: Tải source code OpenClaw

Bạn đang làm gì: Tải mã nguồn OpenClaw từ GitHub — vì cách native Windows cài từ source code, không dùng lệnh cài 1 dòng như trên Mac/Linux.

Truy cập github.com/openclaw/openclaw:

Nhấn nút Code (màu xanh lá) → chọn Download ZIP
Tạo thư mục lưu project, ví dụ: D:\ai\openclaw\
Copy file ZIP vào thư mục vừa tạo → nhấn chuột phải → Extract Here
Sau khi giải nén, bạn có thư mục openclaw-main

Cách biết thành công: Mở thư mục D:\ai\openclaw\openclaw-main — bên trong có file package.json và nhiều thư mục con.

Bước 1.5: Cài dependencies và build

Bạn đang làm gì: Cài tất cả thư viện mà OpenClaw cần (dependencies), rồi build — tức là biên dịch source code thành dạng chạy được.

Mở cmd (Run as Administrator) và truy cập thư mục project:

d:
cd ai\openclaw\openclaw-main

Cài dependencies:

pnpm install

Đợi vài phút. Nếu mạng bị ngắt giữa chừng hoặc báo lỗi timeout → chạy lại pnpm install lần nữa.

Cách biết thành công: Cuối quá trình hiện dòng done hoặc thông báo số packages đã cài, không có dòng ERR! nào.

Tiếp theo, mở Git Bash và truy cập thư mục project:

cd /d/ai/openclaw/openclaw-main

Build project:

pnpm build

Cách biết thành công: Không có dòng lỗi đỏ, cuối cùng hiện thông báo build thành công.

Lưu ý: Bước build có thể mất 2-5 phút tùy cấu hình máy. Nếu gặp lỗi liên quan đến node-gyp hoặc sharp, cần cài thêm Windows Build Tools — chạy trong cmd (Admin): npm install -g windows-build-tools.

Bước 1.6: Khởi chạy OpenClaw

Bạn đang làm gì: Chạy OpenClaw lần đầu tiên và mở Gateway — giao diện web để tương tác với AI assistant.

Trong Git Bash (đang ở thư mục project), gõ:

pnpm start

Đợi vài giây, khi thấy thông báo “ready” hoặc “listening” → OpenClaw đã chạy.

Tiếp theo, mở Gateway:

pnpm openclaw gateway

Cách biết thành công: Terminal hiện địa chỉ http://127.0.0.1:18789. Mở trình duyệt (Chrome/Edge), dán địa chỉ này vào → giao diện OpenClaw hiện ra → bạn đã cài thành công!

Bước 1.7: Cấu hình model AI + API key

Bạn đang làm gì: Chọn model AI (Claude, GPT, Gemini…) và nhập API key để OpenClaw biết dùng “bộ não” nào khi trả lời.

Dừng Gateway trước bằng Ctrl + C trong Git Bash, rồi chạy:

pnpm openclaw configure

Trình cấu hình tương tác hiện lên:

“Where will the Gateway run?” → chọn Local (this machine)
Chọn Model → dùng phím mũi tên lên/xuống để chọn nhà cung cấp AI (OpenAI, Anthropic, Google, xAI…)
Nhập API key → paste key của bạn vào (key lấy từ trang của nhà cung cấp AI)
Nhấn Enter để xác nhận

Cách biết thành công: Chạy lại pnpm openclaw gateway → mở http://127.0.0.1:18789 → gửi tin nhắn thử → bot trả lời.

Chưa có API key? Xem hướng dẫn chi tiết tại Cấu hình API Key OpenClaw — hướng dẫn lấy key cho Claude, GPT, Gemini, và các model khác.

Sau khi tắt máy, khởi chạy lại thế nào?

Bạn không cần cài lại — chỉ cần mở Git Bash và chạy 2 lệnh:

cd /d/ai/openclaw/openclaw-main
pnpm openclaw gateway

Rồi mở trình duyệt vào http://127.0.0.1:18789 — OpenClaw sẵn sàng.

Hạn chế: Cách native Windows không có daemon tự chạy nền — mỗi lần muốn dùng OpenClaw, bạn phải mở Git Bash và chạy lệnh thủ công. Nếu muốn OpenClaw tự khởi động cùng Windows, xem Cách 2 (WSL2) bên dưới.

Cách 2: Cài qua WSL2 (khuyến nghị chính thức)

Cách này cài một lớp Linux nhẹ bên trong Windows, rồi cài OpenClaw giống hệt như trên Mac/Linux. Đây là cách team OpenClaw khuyến nghị vì tương thích tốt nhất.

WSL2 là gì?

WSL2 (Windows Subsystem for Linux 2) là tính năng của Windows cho phép chạy Linux thật sự bên trong Windows — không phải máy ảo nặng nề, mà là một lớp tích hợp nhẹ do Microsoft phát triển, khởi động trong vài giây.

Tại sao cần WSL2? OpenClaw và hầu hết hướng dẫn trong cộng đồng đều viết cho môi trường Unix (Linux/macOS). Chạy qua WSL2 giảm 90% lỗi tương thích so với chạy native trên Windows. Và daemon (dịch vụ chạy nền) hoạt động ổn định hơn nhiều.

Bước 2.1: Cài WSL2 và Ubuntu

Bạn đang làm gì: Bật tính năng WSL2 của Windows và cài bản Ubuntu (một phiên bản Linux phổ biến nhất).

Yêu cầu trước: Virtualization phải được bật trong BIOS. Kiểm tra: mở Task Manager (Ctrl + Shift + Esc) → tab Performance → CPU → mục “Virtualization”. Nếu “Disabled”, cần vào BIOS bật Intel VT-x (Intel) hoặc SVM Mode (AMD).

Mở PowerShell hoặc Windows Terminal với quyền Administrator (nhấn chuột phải → Run as administrator):

wsl --install

Lệnh này tự động: bật tính năng WSL, cài Ubuntu mới nhất, và đặt WSL2 làm mặc định. Sau khi chạy xong, Windows yêu cầu restart. Restart máy, đợi 1-2 phút, cửa sổ Ubuntu tự mở và yêu cầu bạn tạo username + password cho Linux (tài khoản riêng, không liên quan đến Windows).

Cách biết thành công: Thấy dấu nhắc lệnh dạng username@DESKTOP-xxx:~$ — đây là terminal Linux đang chạy bên trong Windows.

Đã cài WSL trước đó? Kiểm tra: wsl --version. Nếu version < 2, nâng cấp: wsl --set-default-version 2.

Bước 2.2: Cài Windows Terminal (tùy chọn)

Bạn đang làm gì: Cài ứng dụng terminal hiện đại của Microsoft — hỗ trợ nhiều tab, tích hợp PowerShell + WSL trong cùng cửa sổ.

Mở Microsoft Store → tìm “Windows Terminal” → Install. Hoặc trong PowerShell:

winget install Microsoft.WindowsTerminal

Cách biết thành công: Mở Windows Terminal → nhấn mũi tên xuống cạnh tab → thấy Ubuntu trong danh sách.

Bước 2.3: Cài Node.js 24 trong WSL

Bạn đang làm gì: Cài Node.js bên trong WSL (Linux), không phải trên Windows. Đây là hai môi trường riêng biệt — OpenClaw chạy trong WSL nên cần Node.js trong WSL.

Mở tab Ubuntu trong Windows Terminal và chạy:

sudo apt update && sudo apt upgrade -y
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

Đóng tab WSL, mở lại (để nvm có hiệu lực), rồi:

nvm install 24
nvm use 24

Cách biết thành công: node -v hiện v24.x.x.

Bước 2.4: Cài OpenClaw

Vẫn trong WSL terminal:

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

Cách biết thành công: Chạy openclaw --version — hiện số phiên bản. Nếu báo command not found, đóng tab WSL mở lại rồi thử lần nữa.

Cách khác: npm install -g openclaw@latest — cho kết quả tương tự.

Bước 2.5: Chạy Onboard Wizard + cài Daemon

openclaw onboard --install-daemon

Wizard hướng dẫn bạn qua 4 bước: cài daemon, chọn model AI + nhập API key, kết nối channel, cấu hình workspace. Chi tiết từng bước xem trong bài tổng quan cài đặt.

Điểm khác biệt so với Cách 1: Ở đây daemon được cài dưới dạng systemd service — tự khởi động khi bạn mở WSL terminal và chạy ngầm, không cần chạy lệnh thủ công mỗi lần.

Cách biết thành công: Chạy openclaw doctor — tất cả hiện OK.

Chưa có API key? Xem Hướng dẫn cấu hình API Key.

Bước 2.6: Giữ WSL chạy nền (để OpenClaw hoạt động 24/7)

Daemon OpenClaw chỉ hoạt động khi WSL đang mở. Hai cách để WSL tự chạy khi bạn đăng nhập Windows:

Cách A — Task Scheduler: Mở Task Scheduler (gõ trong Start menu) → Create Basic Task → tên “WSL OpenClaw Gateway” → Trigger: At log on → Action: Start a program → Program: wsl → Arguments: -d Ubuntu -- openclaw gateway start. Từ giờ, mỗi lần đăng nhập Windows, WSL tự mở ngầm.

Cách B — Windows Terminal startup: Vào Settings → Startup → đặt Default profile là Ubuntu, bật “Launch on machine startup”.

Bước 2.7: Test task đầu tiên

Mở kênh nhắn tin đã kết nối (Telegram, Discord…) hoặc WebChat tại http://localhost:18789 và thử: “Tóm tắt 3 tin công nghệ nổi bật nhất hôm nay”

Bot trả lời → bạn đã cài thành công OpenClaw qua WSL2!

Mẹo làm việc với OpenClaw trên Windows

Truy cập file từ Windows (cho cả 2 cách)

Cách 1 (Native): File cấu hình nằm trong thư mục project, ví dụ D:\ai\openclaw\openclaw-main. Mở trực tiếp bằng bất kỳ text editor nào.

Cách 2 (WSL2): File nằm trong WSL file system. Truy cập từ Windows bằng File Explorer: gõ \\wsl$\Ubuntu\home\<username>\.openclaw vào thanh địa chỉ. Hoặc trong WSL terminal, gõ code ~/.openclaw/ để mở bằng VS Code (cần cài extension “WSL” cho VS Code).

WebChat từ trình duyệt

Cả hai cách đều hỗ trợ WebChat. Mở Chrome/Edge → truy cập http://localhost:18789 (hoặc http://127.0.0.1:18789).

WSL2 tự forward port sang Windows nên dùng localhost bình thường. Nếu không được, lấy IP của WSL: hostname -I rồi truy cập http://<IP>:18789.

Không có menu bar app trên Windows

Khác với macOS (có companion app trên menu bar với Voice Wake, Talk Mode), Windows không có app tương đương. Bạn tương tác qua: kênh nhắn tin, WebChat, hoặc CLI trong terminal.

Xử lý lỗi thường gặp

Lỗi chung cho cả 2 cách

Port bị chiếm (EADDRINUSE): Một ứng dụng khác đang dùng port 18789. Fix — trong cmd hoặc PowerShell:

netstat -ano | findstr :18789
taskkill /PID <PID> /F

Hoặc trong Git Bash / WSL: lsof -i :18789 → kill <PID>.

Windows Defender chặn OpenClaw: Mở Windows Security → Virus & threat protection → Manage settings → Exclusions → Add an exclusion → Folder → thêm thư mục OpenClaw (Cách 1: D:\ai\openclaw\openclaw-main; Cách 2: \\wsl$\Ubuntu\home\<username>\.openclaw).

Lỗi riêng Cách 1 (Native Windows)

Lỗi pnpm install bị timeout/failed: Mạng không ổn định. Chạy lại pnpm install — pnpm sẽ tiếp tục từ chỗ dang dở.

Lỗi node-gyp khi build: Thiếu build tools. Fix:

npm install -g windows-build-tools

Rồi chạy lại pnpm install và pnpm build.

Lỗi pnpm: command not found trong Git Bash: PATH chưa nhận. Đóng Git Bash, mở lại. Hoặc chạy lệnh trong cmd thay vì Git Bash.

Lỗi riêng Cách 2 (WSL2)

WSL2 không cài được — “Virtualization not enabled”: Cần vào BIOS bật Virtualization: restart → nhấn F2/F10/Del → tìm “Intel Virtualization Technology” (Intel) hoặc “SVM Mode” (AMD) → Enabled → Save & Exit.

openclaw: command not found trong WSL: PATH chưa nhận. Fix: source ~/.bashrc hoặc đóng tab WSL mở lại.

WSL chiếm quá nhiều RAM: Mặc định WSL2 dùng đến 50% RAM hệ thống. Giới hạn bằng file .wslconfig: mở PowerShell → notepad "$env:USERPROFILE\.wslconfig" → thêm:

[wsl2]
memory=4GB
processors=2

Lưu file → restart WSL: wsl --shutdown.

Lỗi node-gyp hoặc sharp trong WSL: Thiếu build tools. Fix: sudo apt install -y build-essential python3 rồi chạy lại lệnh cài.

Gặp lỗi khác? Xem danh sách đầy đủ 15+ lỗi tại Lỗi thường gặp khi cài OpenClaw.

Cập nhật và gỡ cài đặt

Cách 1 (Native Windows)

Cập nhật: Tải lại ZIP từ GitHub → giải nén đè thư mục cũ → pnpm install → pnpm build.

Gỡ: Xóa thư mục project (D:\ai\openclaw\) và gỡ Node.js/Git nếu không cần.

Cách 2 (WSL2)

Gỡ:

# Trong WSL — gỡ OpenClaw
npm uninstall -g openclaw
rm -rf ~/.openclaw

# Trong PowerShell — gỡ WSL Ubuntu (nếu không cần nữa)
wsl --unregister Ubuntu

Không muốn setup? Dùng TryOpenClaw.io

Nếu cả hai cách trên nghe phức tạp, TryOpenClaw.io là giải pháp cloud — OpenClaw chạy sẵn trên server, bạn chỉ cần mở trình duyệt:

Không cần cài Node.js, Git, WSL, hay bất kỳ thứ gì
Cloud riêng (isolated instance), backup hàng ngày, uptime 99.9%
Bắt đầu từ 99K VND/tháng, hoàn tiền vô điều kiện

So sánh chi tiết: OpenClaw tự cài vs TryOpenClaw Cloud — nên chọn gì?

Tổng kết

	Cách 1: Native Windows	Cách 2: WSL2
Số bước	7 bước	7 bước
Thời gian	~15-20 phút	~25-35 phút
Khó nhất	Build source (`pnpm build`)	Cài WSL2 lần đầu
Daemon tự chạy	Không	Có (systemd)
Phù hợp	Thử nhanh, không cần 24/7	Dùng lâu dài, đầy đủ tính năng

Dù chọn cách nào, bạn đều có thể truy cập OpenClaw qua trình duyệt tại http://localhost:18789 sau khi cài xong.

Bước tiếp theo: Cấu hình API Key OpenClaw — từ Claude đến GPT để tối ưu model cho workflow của bạn.

Hoặc: Đăng ký TryOpenClaw.io — bỏ qua toàn bộ cài đặt, dùng ngay trong 2 phút.

Cài OpenClaw trên Windows: 2 cách từ đơn giản đến nâng cao (2026)