Skip to main content

​
Windows (WSL2)

OpenClaw on Windows is recommended via WSL2 (Ubuntu recommended). The CLI + Gateway run inside Linux, which keeps the runtime consistent and makes tooling far more compatible (Node/Bun/pnpm, Linux binaries, skills). Native Windows might be trickier. WSL2 gives you the full Linux experience — one command to install: wsl --install. Ứng dụng đồng hành native cho Windows đang được lên kế hoạch.

​
Cài đặt (WSL2)

​
Gateway

​
Cài đặt dịch vụ Gateway (CLI)

Bên trong WSL2:
Hoặc:
Hoặc:
Chọn Gateway service khi được hỏi. Sửa chữa/di chuyển:

​
Nâng cao: mở dịch vụ WSL ra LAN (portproxy)

WSL has its own virtual network. If another machine needs to reach a service running inside WSL (SSH, a local TTS server, or the Gateway), you must forward a Windows port to the current WSL IP. The WSL IP changes after restarts, so you may need to refresh the forwarding rule. Ví dụ (PowerShell chạy với quyền Administrator):
Cho phép cổng đi qua Windows Firewall (một lần):
Làm mới portproxy sau khi WSL khởi động lại:
Ghi chú:
  • SSH từ máy khác nhắm tới IP của máy chủ Windows (ví dụ: ssh user@windows-host -p 2222).
  • Các node từ xa phải trỏ tới một URL Gateway có thể truy cập được (không phải 127.0.0.1); dùng openclaw status --all để xác nhận.
  • Dùng listenaddress=0.0.0.0 để truy cập LAN; 127.0.0.1 chỉ giữ truy cập cục bộ.
  • Nếu muốn tự động, hãy đăng ký một Scheduled Task để chạy bước làm mới khi đăng nhập.

​
Cài đặt WSL2 từng bước

​
1. Cài đặt WSL2 + Ubuntu

Mở PowerShell (Admin):
Khởi động lại nếu Windows yêu cầu.

​
2. Bật systemd (bắt buộc cho cài đặt gateway)

Trong terminal WSL của bạn:
Sau đó từ PowerShell:
Mở lại Ubuntu, rồi kiểm tra:

​
3. Cài đặt OpenClaw (bên trong WSL)

Làm theo luồng Bắt đầu cho Linux bên trong WSL:
Hướng dẫn đầy đủ: Bắt đầu

​
Ứng dụng đồng hành trên Windows

We do not have a Windows companion app yet. Contributions are welcome if you want contributions to make it happen.