Cách cài đặt OpenClaw trên Windows

Q: Tôi có thể cài OpenClaw trên Windows mà không cần WSL không?

Có. OpenClaw cung cấp trình cài đặt PowerShell gốc chạy trực tiếp trên Windows. Mở PowerShell và chạy `iwr -useb https://openclaw.ai/install.ps1 | iex` để cài đặt. Cách này ít bước hơn, nhưng một số tính năng, như quản lý dịch vụ systemd, hoạt động tốt hơn trong môi trường Linux. OpenClaw WSL2 vẫn là lựa chọn cục bộ được khuyến nghị cho nhu cầu sử dụng hằng ngày. Kimi Claw là một lựa chọn khác không cần cài đặt cục bộ.

Q: Vì sao nên dùng WSL2 thay vì PowerShell khi chạy OpenClaw trên Windows?

Chạy OpenClaw trong WSL2 mang lại một môi trường Linux đầy đủ, nơi các tính năng như dịch vụ nền (qua systemd), shell scripting và quy trình build gói npm hoạt động ổn định hơn. Trình cài đặt PowerShell thiết lập nhanh hơn, nhưng chạy trong môi trường hạn chế hơn và kém tương thích với Linux hơn. Nếu bạn muốn trải nghiệm OpenClaw đầy đủ trên Windows mà không phải xử lý các khác biệt khi thiết lập, Kimi Claw cho phép bạn chạy OpenClaw ngay trong trình duyệt, không cần thiết lập cục bộ.

Q: Cách khắc phục lỗi "openclaw is not recognized" trên Windows?

Lỗi này nghĩa là thư mục bin toàn cục của npm chưa có trong PATH hệ thống. Chạy `npm config get prefix` trong PowerShell để tìm tiền tố npm, rồi thêm đường dẫn đó vào biến môi trường Windows. Khởi động lại PowerShell sau khi thay đổi. Đây là một trong những sự cố thường gặp nhất khi cài OpenClaw trên Windows và chỉ ảnh hưởng đến bản cài cục bộ.

Q: OpenClaw có tiếp tục chạy khi PC Windows của tôi tắt hoặc ở chế độ ngủ không?

Không. Nếu cài OpenClaw cục bộ, agent sẽ dừng khi máy tính tắt hoặc chuyển sang chế độ ngủ. WSL2 cũng bị tạm dừng khi Windows ngủ, nghĩa là các tác vụ đã lên lịch và dịch vụ nền sẽ không chạy trong thời gian đó. Để OpenClaw luôn sẵn sàng 24/7 mà không phải bật máy liên tục, Kimi Claw chạy agent của bạn trên các máy chủ đám mây luôn trực tuyến.

Q: OpenClaw có chạy trên Windows không?

Có. OpenClaw chạy trên Windows thông qua trình cài đặt PowerShell gốc hoặc WSL2. OpenClaw WSL2 là cách cài cục bộ được khuyến nghị vì hỗ trợ đầy đủ tính năng, gồm dịch vụ nền `systemd` và các công cụ shell Linux gốc. Hỗ trợ cả Windows 10 và Windows 11. Với người dùng muốn bỏ qua bước thiết lập cục bộ, Kimi Claw chạy OpenClaw trên máy chủ đám mây và có thể truy cập từ bất kỳ trình duyệt nào.

Cài đặt OpenClaw trên Windows bằng PowerShell hoặc WSL2. Hướng dẫn này giải thích cách hoạt động của từng phương pháp để bạn chọn cấu hình phù hợp với nhu cầu. Nếu muốn cách đơn giản hơn, bạn cũng có thể dùng Kimi Claw để chạy agent trên đám mây mà không cần tự thiết lập thủ công.

Dùng thử Kimi Claw

14 phút đọc2026-06-16

OpenClaw là công cụ mạnh mẽ để xây dựng quy trình AI, nhưng việc thiết lập trên Windows có thể gây bối rối cho người mới. Hướng dẫn này sẽ dẫn bạn qua các phương pháp cài đặt chính để có thể bắt đầu nhanh chóng.

Cài đặt OpenClaw trên Windows: so sánh 3 phương pháp

Trước khi đi vào từng bước, dưới đây là tổng quan nhanh về ba cách cài đặt OpenClaw trên Windows. Mỗi phương pháp có những đánh đổi khác nhau về thời gian thiết lập, phạm vi tính năng và yêu cầu kỹ thuật.

	PowerShell	WSL2	Kimi Claw (Trực tuyến)
Cách hoạt động	Trình cài đặt Windows gốc qua dòng lệnh	Môi trường Linux đầy đủ bên trong Windows	Công cụ trực tuyến cho phép người dùng chạy OpenClaw mà không cần thiết lập cục bộ
Độ phức tạp khi thiết lập	Thấp đến trung bình, cần chạy lệnh và làm theo các bước thiết lập	Cao, cần thiết lập Linux, cấu hình hệ thống và cài các phần phụ thuộc	Rất thấp, không cần thiết lập
Có cần code hoặc terminal không	Có	Có	Không
Khả dụng liên tục	Chỉ khi PC của bạn đang chạy	Chỉ khi WSL đang chạy	Khả dụng 24/7, chạy trên máy chủ đám mây
Phù hợp nhất cho	Nhà phát triển quen dùng CLI	Nhà phát triển cần môi trường Linux đầy đủ	Người dùng không chuyên kỹ thuật & nhóm làm việc

Kimi Claw là công cụ trực tuyến cho phép bạn chạy OpenClaw trong trình duyệt. Công cụ này tự động xử lý thiết lập và cấu hình, nên bạn không cần Node.js, WSL hay thiết lập API key. Bạn có thể bắt đầu dùng một agent sẵn sàng hoạt động chỉ trong vài phút.

Để thiết lập cục bộ bằng PowerShell hoặc WSL2, hãy kéo xuống Phương pháp 1 hoặc Phương pháp 2. Nếu muốn bỏ qua hoàn toàn việc cài đặt cục bộ, hãy chuyển đến Phương pháp 3: Kimi Claw. Nếu muốn bắt đầu nhanh hơn, bạn có thể bắt đầu ngay.

Bắt đầu ngay với Kimi Claw

Bạn cần chuẩn bị gì trước khi cài OpenClaw cục bộ trên Windows

Nếu định cài OpenClaw cục bộ, hãy bảo đảm hệ thống của bạn đáp ứng các yêu cầu sau. Nếu chọn phương án đám mây như Kimi Claw, bạn có thể bỏ qua toàn bộ phần này.

Yêu cầu hệ thống

Windows 10 hoặc Windows 11 (64-bit)
Tối thiểu 4 GB RAM (khuyến nghị 8 GB để build npm ổn định)
Kết nối internet ổn định
Quyền quản trị viên cho thiết lập ban đầu nếu bạn chọn WSL2
Với OpenClaw WSL2: phải bật ảo hóa trong BIOS/UEFI

Phần mềm cần thiết

Node.js 22.14 hoặc cao hơn. OpenClaw cần môi trường chạy Node.js hiện đại. Tải xuống từ nodejs.org hoặc cài qua script onboarding.
Git for Windows (không bắt buộc nhưng nên có). Một số gói npm và kỹ năng phụ thuộc vào Git.

Phương pháp 1: Cài OpenClaw trên Windows bằng PowerShell

So với WSL2, phương pháp PowerShell ít bước hơn và không cần môi trường Linux. Chỉ một lệnh sẽ tải OpenClaw, kiểm tra phiên bản Node.js và khởi chạy trình hướng dẫn onboarding. Cách này hoạt động trên cả Windows 10 và Windows 11.

Bước 1: Cài đặt và chạy OpenClaw của bạn

Windows mặc định hạn chế việc thực thi script để bảo vệ hệ thống. Trước khi cài OpenClaw, bạn phải cho phép PowerShell thực thi script cục bộ bằng cách chạy lệnh "công tắc an toàn" này:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Sau đó, chạy lệnh sau:

iwr -useb https://openclaw.ai/install.ps1 | iex

Sau khi chạy lệnh, bạn sẽ thấy kết quả tương tự ảnh chụp màn hình bên dưới. Đóng rồi mở lại PowerShell để làm mới PATH hệ thống trước khi tiếp tục onboarding.

Bước 2: Xác nhận ghi chú rủi ro & chọn chế độ onboarding

Chọn Yes để xác nhận rủi ro và tiếp tục.

Tiếp theo, chọn QuickStart để nhanh chóng bắt đầu onboarding. Bạn có thể điều chỉnh cài đặt sau, hoặc chọn Manual để cấu hình đầy đủ.

Bước 3: Cấu hình và xác thực mô hình AI của bạn

Chọn Moonshot AI làm nhà cung cấp mô hình/xác thực

Xác thực và cấu hình mô hình AI của bạn

Để kết nối OpenClaw, hãy kích hoạt Kimi API Key của bạn qua Kimi Platform. Nạp $5 sẽ nhận được voucher thưởng$ 5, nhưng chúng tôi khuyến nghị nạp từ $20 trở lên để mở quyền truy cập Tier 2. Điều này giúp giảm độ trễ và bảo đảm agent OpenClaw của bạn xử lý tốt các tác vụ phức tạp, nhiều bước.

Tạo Kimi API key

Truy cập mục API Keys và nhấp Create API Key. Lưu ý bạn nên giữ API Key ở nơi an toàn và dễ tìm. Key này chỉ hiển thị một lần khi bạn tạo.

Nhập API key và chọn mô hình mặc định

Khi trình hướng dẫn onboarding yêu cầu, hãy dán API key riêng của bạn vào cửa sổ PowerShell/Terminal.

Khi được yêu cầu chọn mô hình mặc định, hãy chọn moonshot/kimi-k2.5 (hoặc chọn "Keep current" nếu mục này đã được tô sáng). Mô hình này cân bằng tốt nhất giữa tốc độ và khả năng suy luận cho các tác vụ kiểu agent.

Bước 4: Chọn kênh

Chọn ứng dụng bạn muốn kết nối với OpenClaw. Nếu chưa chắc, bạn có thể bỏ qua.

Bước 5: Cấu hình để tối ưu hiệu năng

Nhấp Yes để cấu hình, hoặc No để bỏ qua.

Bước 6: Bật Hooks

Chọn cách trò chuyện với bot của bạn, rồi chờ bot bắt đầu chạy.

Bước 7: Chạy OpenClaw của bạn

Sau khi hoàn tất các bước trên, hãy tận hưởng OpenClaw của bạn.

Giao diện OpenClaw Web UI chạy trên Windows sau khi cài đặt thành công

Phương pháp 2: Cài OpenClaw trên Windows bằng WSL2

Thiết lập OpenClaw WSL2 cung cấp một môi trường Linux đầy đủ bên trong Windows, cũng là cách chính thức được khuyến nghị để chạy OpenClaw. Phương pháp này cho bạn quyền truy cập trọn bộ tính năng, gồm quản lý daemon bằng systemd, viết script shell gốc và build npm mượt hơn. Nếu định dùng OpenClaw trên Windows cho quy trình hằng ngày hoặc phát triển, OpenClaw WSL là lựa chọn tốt nhất.

Bước 1: Bật WSL2 cho OpenClaw trên Windows 11/10

Mở PowerShell với quyền Administrator và chạy:

wsl --install -d Ubuntu

Lệnh này bật WSL, tải xuống Ubuntu và cài đặt. Sau khi quá trình hoàn tất, hãy khởi động lại máy tính. Khi Windows khởi động lại, Ubuntu sẽ mở và yêu cầu bạn tạo tên người dùng cùng mật khẩu.

Nếu bạn đã cài WSL, hãy kiểm tra bằng lệnh:

wsl --list --verbose

Bước 2: Cấu hình WSL2 cho systemd

OpenClaw chạy như một dịch vụ nền bằng systemd. Hãy bật tính năng này trong cấu hình WSL của bạn:

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

Sau đó khởi động lại WSL từ PowerShell:

wsl --shutdown

Mở lại terminal Ubuntu và kiểm tra systemd có đang chạy không:

ps -p 1 -o comm=

Kết quả đầu ra phải hiển thị systemd. Nếu thay vào đó hiển thị init, hãy kiểm tra lại tệp /etc/wsl.conf của bạn.

Bước 3: Cài Node.js 22.14+

OpenClaw yêu cầu Node.js 22.14 trở lên. Hãy cài từ kho NodeSource:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs

Kiểm tra cài đặt:

node --version # Should show v22.x.x or higher npm --version

Bước 4: Cài OpenClaw qua npm

Khi Node.js đã sẵn sàng, hãy cài OpenClaw ở phạm vi toàn cục:

sudo npm install -g openclaw@latest

Ngoài ra, bạn có thể dùng script cài đặt chính thức:

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

Kiểm tra cài đặt:

openclaw --version

Bước 5: Hoàn tất thiết lập OpenClaw trên Windows qua onboarding

Chạy trình hướng dẫn onboarding với cờ daemon để thiết lập OpenClaw làm dịch vụ systemd:

openclaw onboard --install-daemon

Trình hướng dẫn sẽ đưa bạn qua các bước:

Chọn nhà cung cấp LLM và nhập API key của bạn
Chọn mô hình mặc định
Cấu hình kênh nhắn tin (không bắt buộc)
Cài đặt gateway như một dịch vụ nền

Sau onboarding, hãy bật duy trì dịch vụ để OpenClaw tự khởi động khi WSL khởi động:

sudo loginctl enable-linger $USER

Gateway là dịch vụ nền cốt lõi xử lý mọi hoạt động của OpenClaw, bao gồm yêu cầu từ agent, nhắn tin và thực thi mô hình. Việc bảo đảm gateway đang chạy xác nhận rằng bản cài OpenClaw của bạn đã hoàn tất, sẵn sàng sử dụng và tránh lỗi ở các bước tiếp theo.

Chạy lệnh sau trong PowerShell hoặc terminal WSL để kiểm tra trạng thái:

openclaw gateway status

Phương pháp 3: Chạy OpenClaw trên Windows bằng Kimi Claw (không cần thiết lập)

Nếu việc quản lý Node.js, WSL và API key khiến quá trình thiết lập trở nên phức tạp hơn mức bạn cần, Kimi Claw mang đến cách chạy OpenClaw đơn giản hơn. Bạn có thể chạy OpenClaw trực tiếp trong trình duyệt mà không cần thiết lập cục bộ hay cấu hình thủ công. Để bắt đầu, hãy làm theo các bước sau:

Bước 1: Mở Kimi Claw và tạo một instance

Truy cập trang Kimi Claw và nhấp Create để bắt đầu.

Mở Kimi Claw

Tạo một instance OpenClaw mới trên nền tảng đám mây Kimi Claw

Bước 2: Bắt đầu triển khai

Xác nhận triển khai trong cửa sổ bật lên. Kimi Claw sẽ thiết lập môi trường OpenClaw của bạn trong khoảng hai phút, bao gồm gateway, workspace và các công cụ. Không cần lệnh hay cấu hình thủ công.

Kimi Claw tự động triển khai môi trường OpenClaw trên đám mây

Bước 3: Làm việc trong workspace của bạn

Sau khi triển khai xong, workspace của bạn sẽ mở trong dashboard. Ngay trong trình duyệt, bạn có thể bắt đầu trò chuyện với AI agent, thiết lập kỹ năng, cấu hình tác vụ theo lịch và quản lý tệp.

Dùng thử Kimi Claw

Bạn nhận được gì với Kimi Claw

Không cần cấu hình: Không cần quản lý Node.js, WSL hay API key
40 GB lưu trữ đám mây: Lưu báo cáo, bộ dữ liệu và tệp được tạo; dữ liệu vẫn được giữ qua các phiên làm việc
Bộ nhớ liên tục: AI agent của bạn ghi nhớ các tương tác trước đây, sở thích và ngữ cảnh
Hơn 5.000 kỹ năng ClawHub: Truy cập tức thì các kỹ năng tự động hóa, nghiên cứu, lập trình và phân tích
Tự động hóa tác vụ theo lịch: Thiết lập các tác vụ lặp lại như báo cáo hằng ngày, nhắc việc và giám sát
Hoạt động trên mọi thiết bị: Truy cập agent OpenClaw của bạn từ bất kỳ trình duyệt nào trên Windows, Mac hoặc thiết bị di động

Tường lửa Windows và thiết lập bảo mật cho OpenClaw

Kimi Claw tự động xử lý bảo mật và mạng trên máy chủ đám mây. Nếu bạn muốn cài OpenClaw cục bộ bằng PowerShell hoặc WSL2, sau khi cài đặt nên cấu hình một vài thiết lập bảo mật được khuyến nghị.

Cấu hình Windows Firewall

Khi gateway OpenClaw khởi động lần đầu, Windows Firewall có thể yêu cầu bạn cho phép truy cập mạng. Chỉ cho phép với mạng riêng tư. Nếu bạn dùng OpenClaw WSL2, gateway chạy bên trong môi trường Linux và giao tiếp qua localhost, nên thường không cần thêm quy tắc tường lửa.

Nếu Browser Relay hoặc các tính năng khác không thể kết nối, hãy bảo đảm lưu lượng localhost không bị phần mềm bảo mật bên thứ ba như chương trình diệt virus, VPN client hoặc tường lửa doanh nghiệp chặn.

Bảo vệ Control UI

OpenClaw Control UI chạy trên cổng 18789 và cung cấp toàn quyền truy cập vào agent của bạn. Tuyệt đối không mở cổng này ra internet công cộng. Hãy giữ gateway được bind vào 127.0.0.1 và chỉ truy cập từ máy cục bộ của bạn.

Để truy cập từ xa an toàn, hãy dùng Tailscale để tạo đường hầm mạng riêng:

{ "gateway": { "tailscale": { "mode": "serve" } } }

Cách này giữ cổng ở localhost nhưng vẫn cho phép truy cập qua mạng Tailscale riêng của bạn.

Các lỗi cài đặt OpenClaw thường gặp trên Windows và cách khắc phục

Ngay cả khi làm theo hướng dẫn rõ ràng, bạn vẫn có thể gặp sự cố trong quá trình cài đặt. Dưới đây là những vấn đề được báo cáo thường xuyên nhất khi cài OpenClaw trên Windows, cùng cách khắc phục.

OpenClaw không được nhận diện

Nguyên nhân: Thư mục bin toàn cục của npm chưa có trong PATH hệ thống.
Cách khắc phục: Chạy lệnh sau để tìm npm prefix của bạn

npm prefix -g

Thêm đường dẫn đầu ra vào biến môi trường Windows. Không nối thêm \\bin. Sau đó đóng và mở lại PowerShell.

Không tìm thấy Git trong khi cài đặt

Nguyên nhân: Chưa cài Git for Windows.
Cách khắc phục: Tải xuống và cài đặt Git từ git-scm.com. Sau khi cài xong, khởi động lại PowerShell rồi chạy lại trình cài đặt OpenClaw Windows.

Phiên bản Node.js quá cũ

Nguyên nhân: Hệ thống của bạn đang có phiên bản Node.js cũ hơn, không đáp ứng yêu cầu tối thiểu (v22.14+).
Cách khắc phục: Tải phiên bản LTS mới nhất từ nodejs.org và cài đặt. Nếu bạn dùng OpenClaw WSL2, hãy cài lại qua kho NodeSource.

Lỗi bị từ chối quyền truy cập

Nguyên nhân: PowerShell không có đủ quyền, hoặc thư mục toàn cục của npm không cho phép ghi.
Cách khắc phục: Chạy PowerShell với quyền Administrator, hoặc đổi npm global prefix sang thư mục người dùng có quyền ghi

npm config set prefix "$env:APPDATA\npm"

Gateway không khởi động

Nguyên nhân: Port 18789 đã được sử dụng, hoặc tệp cấu hình bị hỏng.
Cách khắc phục: Kiểm tra các tiến trình xung đột và khởi động lại

# Check what is using the port netstat -ano | findstr :18789 # Restart the gateway openclaw gateway restart

WSL2 systemd không hoạt động

Nguyên nhân: Tệp /etc/wsl.conf thiếu cấu hình systemd.
Cách khắc phục: Kiểm tra tệp có chứa đúng thiết lập

cat /etc/wsl.conf # Should include: # [boot] # systemd=true

Nếu thiếu thiết lập này, hãy thêm vào rồi khởi động lại WSL bằng wsl --shutdown trong PowerShell.

Kết luận

Việc cài đặt OpenClaw trên Windows có thể đơn giản chỉ với một script, hoặc nâng cao hơn với môi trường WSL2, tùy nhu cầu của bạn. Nếu muốn toàn quyền kiểm soát và linh hoạt, PowerShell và WSL2 đều là lựa chọn vững chắc. Nếu muốn bỏ qua khâu thiết lập và bắt đầu ngay, Kimi Claw cho phép bạn chạy OpenClaw trong trình duyệt mà không cần thiết lập cục bộ. Hãy chọn cách phù hợp với quy trình làm việc và mức độ quen thuộc kỹ thuật của bạn, rồi bạn sẽ sẵn sàng khai thác tối đa OpenClaw.

Dùng thử Kimi Claw

Câu hỏi thường gặp

Tôi có thể cài OpenClaw trên Windows mà không cần WSL không?

Có. OpenClaw cung cấp trình cài đặt PowerShell gốc chạy trực tiếp trên Windows. Mở PowerShell và chạy iwr -useb https://openclaw.ai/install.ps1 | iex để cài đặt. Cách này ít bước hơn, nhưng một số tính năng, như quản lý dịch vụ systemd, hoạt động tốt hơn trong môi trường Linux. OpenClaw WSL2 vẫn là lựa chọn cục bộ được khuyến nghị cho nhu cầu sử dụng hằng ngày. Kimi Claw là một lựa chọn khác không cần cài đặt cục bộ.

Vì sao nên dùng WSL2 thay vì PowerShell khi chạy OpenClaw trên Windows?

Chạy OpenClaw trong WSL2 mang lại một môi trường Linux đầy đủ, nơi các tính năng như dịch vụ nền (qua systemd), shell scripting và quy trình build gói npm hoạt động ổn định hơn. Trình cài đặt PowerShell thiết lập nhanh hơn, nhưng chạy trong môi trường hạn chế hơn và kém tương thích với Linux hơn. Nếu bạn muốn trải nghiệm OpenClaw đầy đủ trên Windows mà không phải xử lý các khác biệt khi thiết lập, Kimi Claw cho phép bạn chạy OpenClaw ngay trong trình duyệt, không cần thiết lập cục bộ.

Cách khắc phục lỗi "openclaw is not recognized" trên Windows?

Lỗi này nghĩa là thư mục bin toàn cục của npm chưa có trong PATH hệ thống. Chạy npm config get prefix trong PowerShell để tìm tiền tố npm, rồi thêm đường dẫn đó vào biến môi trường Windows. Khởi động lại PowerShell sau khi thay đổi. Đây là một trong những sự cố thường gặp nhất khi cài OpenClaw trên Windows và chỉ ảnh hưởng đến bản cài cục bộ.

OpenClaw có tiếp tục chạy khi PC Windows của tôi tắt hoặc ở chế độ ngủ không?

Không. Nếu cài OpenClaw cục bộ, agent sẽ dừng khi máy tính tắt hoặc chuyển sang chế độ ngủ. WSL2 cũng bị tạm dừng khi Windows ngủ, nghĩa là các tác vụ đã lên lịch và dịch vụ nền sẽ không chạy trong thời gian đó. Để OpenClaw luôn sẵn sàng 24/7 mà không phải bật máy liên tục, Kimi Claw chạy agent của bạn trên các máy chủ đám mây luôn trực tuyến.

OpenClaw có chạy trên Windows không?

Có. OpenClaw chạy trên Windows thông qua trình cài đặt PowerShell gốc hoặc WSL2. OpenClaw WSL2 là cách cài cục bộ được khuyến nghị vì hỗ trợ đầy đủ tính năng, gồm dịch vụ nền systemd và các công cụ shell Linux gốc. Hỗ trợ cả Windows 10 và Windows 11. Với người dùng muốn bỏ qua bước thiết lập cục bộ, Kimi Claw chạy OpenClaw trên máy chủ đám mây và có thể truy cập từ bất kỳ trình duyệt nào.

Có thể bạn cũng sẽ thích