Cài đặt OpenClaw trên Windows từ A đến Z, kèm lỗi thật

Cài đặt OpenClaw trên Windows gồm bốn việc: chạy trình cài bằng PowerShell quyền Administrator, đi qua trình thiết lập để nhập API key của model, cài Gateway chạy nền, rồi (nếu muốn) cho trợ lý điều khiển màn hình. Trên máy sạch mình cài ngày 10/10/2026, cả quá trình mất khoảng 25 phút, trong đó riêng bước npm tải gói chiếm 11 phút.

Thời gian từng bước đo trên máy thuê ngày 10/10/2026:

Bài này dựa trên hai lần cài thật: một máy Windows 10 LTSC thuê theo giờ (máy sạch, chụp lại từng màn hình) và máy Windows 11 Pro của một khách đã từng cài OpenClaw bản cũ. Những gì cần chuẩn bị:

• Windows 10 bản 20H2 trở lên hoặc Windows 11, tài khoản có quyền Administrator.

• API key của một nhà cung cấp model. Mình dùng DeepSeek vì rẻ, khách dùng OpenAI.

• Một bot Telegram nếu muốn nhắn việc từ điện thoại. Phần này có bài riêng: OpenClaw Telegram.

Chưa rõ OpenClaw là gì thì đọc bài OpenClaw là gì trước.

Máy Windows nào cài đặt OpenClaw được?#

Trên máy cá nhân, Windows thường chặn chạy file .ps1. Lệnh openclaw khi đó báo "running scripts is disabled on this system". Mở PowerShell rồi chạy một lần lệnh sau, bấm Y khi được hỏi:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Bước 1: chạy trình cài OpenClaw bằng lệnh nào?#

Bấm vào ô tìm kiếm trên thanh taskbar, gõ powershell, chọn Run as administrator:

Trang chủ OpenClaw ghi lệnh iwr -useb https://openclaw.ai/install.ps1 | iex. Trên PowerShell 5.1, bản có sẵn trong Windows 10 và 11, lệnh này báo lỗi đỏ và không cài gì:

Lệnh chạy được là bọc script vào một scriptblock rồi mới chạy:

& ([scriptblock]::Create((irm https://openclaw.ai/install.ps1)))

Trình cài tự kiểm tra Node.js, rồi chạy npm install openclaw@latest. Màn hình đứng im ở dòng Installing OpenClaw (openclaw@latest)... một lúc lâu là bình thường. Trên máy thuê, mình bấm Enter lúc 12:40 và tới 12:51 mới xong. Trong lúc chờ đừng click vào vùng chữ của PowerShell: click vào đó sẽ bật chế độ Select, tiêu đề cửa sổ đổi thành "Select…" và trình cài đứng hẳn cho tới khi bạn bấm Esc.

Dòng "Windows detected - OpenClaw runs great on WSL2!" chỉ là gợi ý. Trang OpenClaw trên Windows của tài liệu chính thức liệt kê ba cách: app Windows Hub, cài CLI bằng PowerShell như bài này, hoặc chạy Gateway trong WSL2. Không cần WSL. Muốn trợ lý điều khiển được màn hình Windows thì OpenClaw phải chạy thẳng trên Windows như bài này.

Bước 2: trình thiết lập hỏi những gì?#

Trình thiết lập (onboard) tự mở sau khi cài. Dùng phím mũi tên để chọn, Enter để xác nhận:

1. How would you like to start? chọn Quick start (recommended).

2. What would you like to create? chọn One agent.

3. Model/auth provider: OpenAI nằm ngay dòng đầu. DeepSeek thì phải chọn More… rồi gõ deepseek để lọc.

Chọn DeepSeek thì trình thiết lập hỏi có tải plugin @openclaw/deepseek-provider từ npm không, chọn Download from npm, chờ khoảng 30 giây. Tới ô Enter DeepSeek API key, dán key bằng chuột phải. Key chỉ hiện dạng dấu chấm:

Với OpenAI, màn hình kế tiếp hỏi cách đăng nhập: chọn OpenAI API Key rồi dán key. Máy khách của mình chọn OpenAI, trình thiết lập gọi thử ngay và in Inference verified: openai/gpt-6-astra, trả lời sau 9,9 giây. Model đó là loại đắt nhất của OpenAI, đọc bài OpenClaw có miễn phí không trước khi chat nhiều.

Bước 3: cho Gateway chạy nền#

Quick start không cài Gateway thành dịch vụ. Trên máy khách, trình thiết lập còn tự chạy Gateway ngay trong cửa sổ PowerShell và mở dashboard trên trình duyệt, đóng cửa sổ là bot tắt theo. Nhấn Ctrl + C để dừng nó, rồi cài dịch vụ:

openclaw gateway install
openclaw gateway status

Chạy status ngay sau lệnh cài sẽ thấy Connectivity probe: failed vì Gateway còn đang khởi động. Trên máy thuê, từ lúc Task Scheduler bật tới khi Gateway mở cổng mất 67 giây. Chờ một phút rồi chạy lại:

Kết quả đúng có Service: Scheduled Task (registered), bind=loopback (127.0.0.1), Runtime: running và Connectivity probe: ok. loopback nghĩa là Gateway chỉ nhận kết nối từ chính máy này, máy khác trong mạng không vào được. Giữ nguyên như vậy.

Bước 4: đổi sang model rẻ cho đúng cách#

Trình thiết lập chọn DeepSeek thì đặt model mặc định deepseek-v4-pro, chỉ đọc được chữ. Muốn trợ lý nhìn ảnh màn hình để điều khiển máy, mình đổi sang deepseek-flash (V4.1 Flash, đọc được ảnh). Lệnh đổi phải đi kèm khai báo bộ chạy openclaw cho model, nếu không OpenClaw tự bật bộ chạy Codex:

openclaw plugins disable codex
openclaw models set deepseek/deepseek-flash
openclaw config set agents.defaults.models '{\"deepseek/deepseek-flash\":{\"agentRuntime\":{\"id\":\"openclaw\"}}}' --replace

Dấu \" trong lệnh thứ ba là cố ý: PowerShell 5.1 làm rơi dấu ngoặc kép khi truyền vào chương trình. Tham số --replace thay cả danh sách model, nếu thiếu nó OpenClaw từ chối với câu "Refusing to replace agents.defaults.models; it would remove existing entries".

Bước 5: cho trợ lý điều khiển máy tính#

Phần này dùng plugin cua-computer và một node chạy trong phiên đăng nhập Windows. Tài liệu OpenClaw ghi plugin này trên Windows còn thử nghiệm và chỉ điều khiển màn hình chính:

openclaw plugins enable cua-computer
openclaw node install --display-name may-cua-ban
openclaw nodes pending

Tên sau --display-name đặt tùy ý, chỉ để bạn nhận ra máy trong danh sách node. Ảnh dưới là máy của mình, đặt tên khác:

Khoảng 15 giây sau, nodes pending hiện một yêu cầu kèm mã ở cột Request. Duyệt bằng openclaw nodes approve <mã>. Kết quả liệt kê các quyền, phải có computer.act (bấm chuột, gõ phím) và screen.snapshot (chụp màn hình):

Cuối cùng bật chế độ xin phép cho lệnh lạ và tắt chế độ ngủ khi cắm điện:

openclaw exec-policy preset cautious
powercfg /change standby-timeout-ac 0
powercfg /change hibernate-timeout-ac 0

Lỗi mình đã gặp khi cài đặt OpenClaw trên Windows#

Lỗi 1: lệnh cài chính thức báo lỗi. Nguyên văn trên PowerShell 5.1:

iex : The attribute cannot be added because variable NodeVersion with value  would no longer be valid.

Dùng lệnh & ([scriptblock]::Create((irm https://openclaw.ai/install.ps1))) ở bước 1.

Lỗi 2: báo hỏng ngay sau khi dán API key. Gặp trên cả hai máy Windows:

Config write rejected: C:\Users\Administrator\.openclaw\openclaw.json (size-drop:1271->575).
Activation failed and recovery could not complete.

Key vẫn được lưu. Kiểm tra bằng openclaw models status, thấy model mặc định và 1 api-key là xong, đi tiếp bước 3:

Lỗi 3: máy đã từng cài OpenClaw. Trên máy khách, trình cài báo Upgrade complete thay vì cài mới, không mở trình thiết lập, kèm SERVICE_DEFINITION_UNKNOWN: Service definition cannot be safely inspected. Lệnh gỡ openclaw uninstall --all --yes --non-interactive gỡ được tác vụ nền nhưng giữ lại dữ liệu vì không xác định được Gateway cũ. Mình sao lưu thư mục .openclaw ra Desktop rồi dọn tay:

Copy-Item -Recurse "$env:USERPROFILE\.openclaw" "$env:USERPROFILE\Desktop\openclaw-ban-cu"
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
npm rm -g openclaw

Lỗi 4: Gateway treo, CPU chạy liên tục. Trên máy khách, sau khi đổi model OpenAI bằng models set, Gateway mở được cổng nhưng không trả lời, gateway status báo timed out before reaching Gateway, tiến trình ngốn khoảng 2 nhân CPU. Log có dòng codex agent runtime configured, enabled automatically. Model mới không có khai báo bộ chạy nên OpenClaw tự bật Codex, và Gateway kẹt ở đó. Sửa bằng ba lệnh ở bước 4, thay tên model cho đúng.

Lỗi 5: Windows Defender báo "Threats found". Trên máy thuê, đúng lúc mình chạy openclaw channels add, góc màn hình hiện cảnh báo của Defender:

Mình xem chi tiết bằng Get-MpThreatDetection: Defender bắt VirTool:Win32/DefenderTamperingRestore ở khóa registry tắt Defender. Đây là cấu hình có sẵn của ảnh Windows trên máy thuê, OpenClaw không đụng tới. Nếu máy bạn gặp cảnh báo, xem tên mối đe dọa trước khi kết luận.

Khởi động lại máy thì Gateway có tự lên không?#

Có, nhưng không chắc chắn. Tác vụ "OpenClaw Gateway" và "OpenClaw Node" chạy khi bạn đăng nhập Windows, không chạy trước đó. Trên máy khách, sau một lần khởi động lại, Node lên còn Gateway bật rồi thoát ngay, log ghi lúc 40 giây sau khi khởi động:

Cannot read shared state for discovery: C:\Users\Admin\.openclaw\state\openclaw.sqlite. Retry after the current state operation completes.

Gateway và Node khởi động cùng lúc và tranh nhau file openclaw.sqlite, Gateway thua thì thoát luôn, Task Scheduler không bật lại. Cách mình đang dùng là cho Gateway chờ 1 phút sau khi đăng nhập:

$t = (Get-ScheduledTask "OpenClaw Gateway").Triggers[0]; $t.Delay = "PT1M"
Set-ScheduledTask -TaskName "OpenClaw Gateway" -Trigger $t

Chạy lại openclaw update hay openclaw gateway install --force có thể tạo lại tác vụ và mất khoảng chờ này. So với Ubuntu thì đây là điểm Windows thua rõ: trên Ubuntu, OpenClaw chạy bằng systemd với Restart=always, có lỗi là tự bật lại sau 5 giây.

Khi nào không nên cài OpenClaw trên Windows?#

Nếu bạn chỉ cần trợ lý chat qua Telegram, không cần nó điều khiển màn hình, một máy chủ Ubuntu cài nhanh hơn nhiều (46 giây so với 11 phút) và tự khởi động lại khi lỗi. Windows đáng chọn khi việc cần làm nằm trên chính máy Windows bạn đang dùng hằng ngày: mở phần mềm, sửa file, thao tác trên giao diện.

Đừng cài lên máy đang chứa dữ liệu khách hàng, kế toán mà không khóa bot và bật chế độ xin phép. Trợ lý chạy với đúng quyền của tài khoản Windows của bạn.

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

Cài OpenClaw trên Windows có cần WSL không?#

Không. Bài này cài thẳng trên Windows. WSL chỉ cần nếu bạn muốn Gateway chạy trong Linux, khi đó nó không điều khiển được màn hình Windows.

Có cần cài Node.js trước không?#

Không bắt buộc. Trình cài tự tải Node riêng cho OpenClaw nếu máy chưa có. Máy đã có Node từ 24.16 trở lên thì nó dùng luôn.

Tắt màn hình hoặc khóa máy thì trợ lý còn chạy không?#

Tắt màn hình thì vẫn chạy. Khóa máy (Win + L) thì vẫn chat và chạy lệnh được, nhưng không bấm chuột, gõ phím trên giao diện được nữa.

Muốn gỡ OpenClaw thì làm sao?#

Chạy openclaw uninstall --dry-run --all để xem trước, rồi openclaw uninstall --all --yes --non-interactive, cuối cùng npm rm -g openclaw. Nếu thư mục .openclaw vẫn còn, xóa tay sau khi đã sao lưu.

Đọc tiếp#

• OpenClaw Telegram: nối bot, khóa người lạ, duyệt lệnh: bước tiếp theo sau khi cài xong.

• OpenClaw có miễn phí không: chọn model để không bị trừ tiền quá tay.

• OpenClaw là gì: tổng quan, so sánh với ChatGPT, bảo mật.

• n8n là gì và tự host n8n bằng Docker trên VPS: khi bạn muốn tự động hóa theo quy trình cố định.

Không muốn để máy nhà bật suốt ngày, bạn có thể thuê một máy Windows hoặc Ubuntu theo giờ trên AIDev Cloud để chạy OpenClaw 24/7. Cần người cài và khóa cấu hình giúp, AIDev nhận cài trọn gói qua trang liên hệ.

Cài và chụp ngày 10/10/2026 trên máy CPU Starter của AIDev Cloud (Windows 10 IoT Enterprise LTSC 21H2, 8 nhân, 16GB RAM, Node.js 24.18), OpenClaw 2026.9.9. Phần lỗi 3, 4 và khởi động lại ghi từ máy Windows 11 Pro 25H2 của khách ngày 09/10/2026.