Windows

OpenClaw รองรับทั้ง Windows แบบเนทีฟ และ WSL2 WSL2 เป็นเส้นทางที่เสถียรกว่าและแนะนำสำหรับประสบการณ์เต็มรูปแบบ — CLI, Gateway และเครื่องมือต่าง ๆ ทำงานภายใน Linux พร้อมความเข้ากันได้เต็มรูปแบบ Windows แบบเนทีฟใช้งานได้สำหรับ CLI หลักและการใช้งาน Gateway โดยมีข้อควรระวังบางอย่างที่ระบุไว้ด้านล่าง

มีแผนสำหรับแอปคู่หูบน Windows แบบเนทีฟ

# WSL2 (แนะนำ)

• เริ่มต้นใช้งาน (ใช้ภายใน WSL)
• การติดตั้งและอัปเดต
• คู่มือ WSL2 อย่างเป็นทางการ (Microsoft): https://learn.microsoft.com/windows/wsl/install

# สถานะ Windows แบบเนทีฟ

โฟลว์ CLI บน Windows แบบเนทีฟกำลังปรับปรุงอยู่ แต่ WSL2 ยังคงเป็นเส้นทางที่แนะนำ

สิ่งที่ทำงานได้ดีบน Windows แบบเนทีฟในปัจจุบัน:

• ตัวติดตั้งผ่านเว็บไซต์ด้วย install.ps1
• การใช้งาน CLI แบบ local เช่น openclaw --version, openclaw doctor และ openclaw plugins list --json
• การทดสอบ smoke ของ local-agent/provider แบบฝังตัว เช่น:

openclaw agent --local --agent main --thinking low -m "Reply with exactly WINDOWS-HATCH-OK."

ข้อควรระวังปัจจุบัน:

• openclaw onboard --non-interactive ยังคงคาดหวัง Gateway แบบ local ที่เข้าถึงได้ เว้นแต่คุณจะส่ง --skip-health
• openclaw onboard --non-interactive --install-daemon และ openclaw gateway install จะลองใช้ Windows Scheduled Tasks ก่อน
• หากการสร้าง Scheduled Task ถูกปฏิเสธ OpenClaw จะถอยกลับไปใช้รายการเข้าสู่ระบบในโฟลเดอร์ Startup ต่อผู้ใช้ และเริ่ม Gateway ทันที
• หาก schtasks ค้างหรือหยุดตอบสนอง OpenClaw จะยกเลิกเส้นทางนั้นอย่างรวดเร็วและถอยกลับแทนที่จะค้างตลอดไป
• Scheduled Tasks ยังคงเป็นตัวเลือกที่ต้องการเมื่อใช้งานได้ เพราะให้สถานะตัวควบคุมบริการที่ดีกว่า

หากคุณต้องการเฉพาะ CLI แบบเนทีฟ โดยไม่ติดตั้งบริการ Gateway ให้ใช้หนึ่งในคำสั่งเหล่านี้:

openclaw onboard --non-interactive --skip-health
openclaw gateway run

หากคุณต้องการการเริ่มต้นแบบจัดการบน Windows แบบเนทีฟ:

openclaw gateway install
openclaw gateway status --json

หากการสร้าง Scheduled Task ถูกบล็อก โหมดบริการสำรองจะยังคงเริ่มอัตโนมัติหลังเข้าสู่ระบบผ่านโฟลเดอร์ Startup ของผู้ใช้ปัจจุบัน

# Gateway

• คู่มือปฏิบัติการ Gateway
• การกำหนดค่า

# การติดตั้งบริการ Gateway (CLI)

ภายใน WSL2:

openclaw onboard --install-daemon

หรือ:

openclaw gateway install

หรือ:

openclaw configure

เลือก บริการ Gateway เมื่อระบบถาม

ซ่อมแซม/ย้ายข้อมูล:

openclaw doctor

# การเริ่ม Gateway อัตโนมัติก่อนเข้าสู่ระบบ Windows

สำหรับการตั้งค่าแบบไม่มีหน้าจอ ให้ตรวจสอบว่าห่วงโซ่การบูตทั้งหมดทำงานแม้ไม่มีใครเข้าสู่ระบบ Windows

# 1) ให้บริการผู้ใช้ทำงานต่อโดยไม่ต้องเข้าสู่ระบบ

ภายใน WSL:

sudo loginctl enable-linger "$(whoami)"

# 2) ติดตั้งบริการผู้ใช้ OpenClaw gateway

ภายใน WSL:

openclaw gateway install

# 3) เริ่ม WSL อัตโนมัติเมื่อ Windows บูต

ใน PowerShell ในฐานะผู้ดูแลระบบ:

schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec /bin/true" /sc onstart /ru SYSTEM

แทนที่ Ubuntu ด้วยชื่อดิสโทรของคุณจาก:

wsl --list --verbose

# ตรวจสอบห่วงโซ่การเริ่มต้น

หลังรีบูต (ก่อนลงชื่อเข้าใช้ Windows) ให้ตรวจสอบจาก WSL:

systemctl --user is-enabled openclaw-gateway.service
systemctl --user status openclaw-gateway.service --no-pager

# ขั้นสูง: เปิดบริการ WSL ให้เข้าถึงผ่าน LAN (portproxy)

WSL มีเครือข่ายเสมือนของตัวเอง หากเครื่องอื่นจำเป็นต้องเข้าถึงบริการที่ทำงาน ภายใน WSL (SSH, เซิร์ฟเวอร์ TTS แบบ local หรือ Gateway) คุณต้องส่งต่อพอร์ตของ Windows ไปยัง IP ของ WSL ปัจจุบัน IP ของ WSL จะเปลี่ยนหลังรีสตาร์ต ดังนั้นคุณอาจต้องรีเฟรชกฎการส่งต่อ

ตัวอย่าง (PowerShell ในฐานะผู้ดูแลระบบ):

$Distro = "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

อนุญาตพอร์ตผ่าน Windows Firewall (ครั้งเดียว):

New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
  -Protocol TCP -LocalPort $ListenPort -Action Allow

รีเฟรช portproxy หลัง WSL รีสตาร์ต:

netsh interface portproxy delete v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 | Out-Null
netsh interface portproxy add v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 `
  connectaddress=$WslIp connectport=$TargetPort | Out-Null

หมายเหตุ:

• SSH จากเครื่องอื่นจะชี้ไปที่ IP ของโฮสต์ Windows (ตัวอย่าง: ssh user@windows-host -p 2222)
• โหนดระยะไกลต้องชี้ไปยัง URL ของ Gateway ที่ เข้าถึงได้ (ไม่ใช่ 127.0.0.1); ใช้ openclaw status --all เพื่อยืนยัน
• ใช้ listenaddress=0.0.0.0 สำหรับการเข้าถึงผ่าน LAN; 127.0.0.1 จะทำให้เป็น local เท่านั้น
• หากคุณต้องการให้ทำงานอัตโนมัติ ให้ลงทะเบียน Scheduled Task เพื่อรันขั้นตอนรีเฟรชเมื่อเข้าสู่ระบบ

# การติดตั้ง WSL2 แบบทีละขั้นตอน

# 1) ติดตั้ง WSL2 + Ubuntu

เปิด PowerShell (ผู้ดูแลระบบ):

wsl --install
# Or pick a distro explicitly:
wsl --list --online
wsl --install -d Ubuntu-24.04

รีบูตหาก Windows แจ้งให้ทำ

# 2) เปิดใช้งาน systemd (จำเป็นสำหรับการติดตั้ง Gateway)

ในเทอร์มินัล WSL ของคุณ:

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

จากนั้นจาก PowerShell:

wsl --shutdown

เปิด Ubuntu อีกครั้ง แล้วตรวจสอบ:

systemctl --user status

# 3) ติดตั้ง OpenClaw (ภายใน WSL)

สำหรับการตั้งค่าครั้งแรกตามปกติภายใน WSL ให้ทำตามโฟลว์เริ่มต้นใช้งาน Linux:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build
pnpm openclaw onboard --install-daemon

หากคุณกำลังพัฒนาจากซอร์สแทนการเริ่ม onboarding ครั้งแรก ให้ใช้ local dev loop จาก การตั้งค่า:

pnpm install
# First run only (or after resetting local OpenClaw config/workspace)
pnpm openclaw setup
pnpm gateway:watch

คู่มือฉบับเต็ม: เริ่มต้นใช้งาน

# แอปคู่หู Windows

เรายังไม่มีแอปคู่หู Windows ในตอนนี้ ยินดีรับการมีส่วนร่วมหากคุณต้องการช่วยทำให้เกิดขึ้น

# การเชื่อมต่อ Git และ GitHub (ผู้มีส่วนร่วม)

บางเครือข่ายบล็อกหรือจำกัด HTTPS ไปยัง GitHub หาก git clone ล้มเหลวด้วย timeout หรือการรีเซ็ตการเชื่อมต่อ ให้ลองใช้เครือข่ายอื่น, VPN หรือพร็อกซี HTTP/HTTPS ที่องค์กรของคุณจัดเตรียมไว้

หาก gh auth login ล้มเหลวระหว่างโฟลว์อุปกรณ์ผ่านเบราว์เซอร์ (เช่น timeout ขณะเข้าถึง github.com:443) ให้ตรวจสอบสิทธิ์ด้วย personal access token แทน:

1. สร้าง token ที่มี scope อย่างน้อย repo (classic PAT) หรือสิทธิ์แบบ fine-grained ที่เทียบเท่า
2. ใน PowerShell สำหรับเซสชันปัจจุบัน:

$env:GH_TOKEN="<your-token>"
gh auth status
gh auth setup-git

3. หาก gh auth status เตือนว่าไม่มี read:org ให้สร้าง token ที่มี scope นั้นและกำหนดตัวแปรใหม่:

$env:GH_TOKEN="<your-token-with-repo-and-read:org>"
gh auth status

gh auth refresh -s read:org ใช้ได้เฉพาะเมื่อคุณตรวจสอบสิทธิ์ผ่าน gh auth login และมี credentials ที่จัดเก็บไว้ให้รีเฟรช (ไม่ใช่เมื่อใช้ GH_TOKEN)

อย่า commit token หรือวาง token ลงใน issues หรือ pull requests

# ที่เกี่ยวข้อง

• ภาพรวมการติดตั้ง
• แพลตฟอร์ม