Windows

OpenClaw มาพร้อมแอปคู่หู Windows Hub แบบเนทีฟ พร้อมการรองรับ Windows CLI ใช้ Windows Hub เมื่อคุณต้องการแอปเดสก์ท็อปที่มีการตั้งค่า สถานะในถาดระบบ แชต การวินิจฉัยของ Command Center และความสามารถของโหนด Windows ใช้ตัวติดตั้ง PowerShell เมื่อคุณต้องการ CLI/Gateway โดยตรง ใช้ WSL2 เมื่อคุณต้องการรันไทม์ Gateway ที่เข้ากันได้กับ Linux มากที่สุด

แนะนำ: Windows Hub

Windows Hub คือแอปคู่หู WinUI แบบเนทีฟสำหรับ Windows 10 20H2+ และ Windows 11 แอปนี้ติดตั้งได้โดยไม่ต้องมีสิทธิ์ผู้ดูแลระบบ และเผยแพร่พร้อมตัวติดตั้ง x64 และ ARM64 ที่ลงลายเซ็นแล้วในรุ่นเผยแพร่ของ OpenClaw

ดาวน์โหลดตัวติดตั้งเสถียรรุ่นล่าสุดจาก หน้ารุ่นเผยแพร่ของ OpenClaw:

• OpenClawCompanion-Setup-x64.exe
• OpenClawCompanion-Setup-arm64.exe
• Checksums

หากลิงก์ดาวน์โหลดด้านบนคืนค่า 404 ให้ไปที่ หน้ารุ่นเผยแพร่ และมองหาแอสเซ็ต OpenClawCompanion-Setup-* ในรุ่นเผยแพร่ล่าสุด

หลังติดตั้ง ให้เปิด OpenClaw Companion จากเมนู Start หรือถาดระบบ ตัวติดตั้งยังเพิ่มทางลัดสำหรับการตั้งค่า Gateway, Chat, Settings, Check for Updates และถอนการติดตั้งด้วย

สิ่งที่ Windows Hub มีให้

• สถานะในถาดระบบและการเปิดเมื่อเข้าสู่ระบบ
• การตั้งค่าครั้งแรกสำหรับ WSL Gateway ภายในเครื่องที่แอปเป็นเจ้าของ
• การตั้งค่าการเชื่อมต่อสำหรับ Gateway ภายในเครื่อง ระยะไกล และผ่าน SSH tunnel
• หน้าต่างแชตแบบเนทีฟ พร้อมการเข้าถึง Control UI ผ่านเบราว์เซอร์
• การวินิจฉัยของ Command Center สำหรับเซสชัน การใช้งาน ช่องทาง โหนด การจับคู่ และ คำสั่งซ่อมแซม
• โหมดโหนด Windows สำหรับ canvas ที่ควบคุมโดยเอเจนต์ หน้าจอ กล้อง การแจ้งเตือน สถานะอุปกรณ์ การแปลงข้อความเป็นเสียง การแปลงเสียงเป็นข้อความ และ system.run ที่ถูกควบคุม
• โหมดเซิร์ฟเวอร์ MCP ภายในเครื่องสำหรับไคลเอนต์ MCP เช่น Claude Desktop, Claude Code และ Cursor

การเปิดใช้งานครั้งแรก

เมื่อเปิดใช้งานครั้งแรก Windows Hub จะเปิดการตั้งค่าเมื่อไม่มี Gateway ที่บันทึกไว้และใช้งานได้ เส้นทางที่เร็วที่สุดคือ Set up locally ซึ่งจะจัดเตรียมดิสโทร WSL OpenClawGateway ที่แอปเป็นเจ้าของ ติดตั้ง Gateway ข้างในนั้น และจับคู่แอป การทำเช่นนี้จะไม่ส่งออกหรือแก้ไขดิสโทร Ubuntu ที่คุณมีอยู่

เลือก Advanced setup หรือเปิดแท็บ Connections เมื่อคุณมี Gateway อยู่แล้ว คุณสามารถเชื่อมต่อกับ:

• Gateway ภายในเครื่องบนพีซีเครื่องนี้
• WSL Gateway บนพีซีเครื่องนี้
• Gateway ระยะไกลด้วย URL และโทเค็นหรือรหัสตั้งค่า
• Gateway ที่เข้าถึงผ่าน SSH tunnel

เมื่อตั้งค่าเสร็จ ไอคอนในถาดระบบจะเปลี่ยนเป็นสีเขียว เปิด Command Center จากถาดระบบ เพื่อยืนยันการเชื่อมต่อ การจับคู่ สถานะโหนด และสุขภาพของช่องทาง

โหมดโหนด Windows

Windows Hub สามารถลงทะเบียนเป็นโหนด OpenClaw ชั้นหนึ่งได้ จากนั้นเอเจนต์สามารถใช้ ความสามารถแบบเนทีฟของ Windows ที่ประกาศไว้ผ่าน Gateway

คำสั่งทั่วไปประกอบด้วย:

• canvas.present, canvas.hide, canvas.navigate, canvas.eval, canvas.snapshot
• screen.snapshot และ screen.record เมื่อยินยอมอย่างชัดเจน
• camera.list และ camera.snap, camera.clip เมื่อยินยอมอย่างชัดเจน
• system.notify, system.run, system.run.prepare, system.which
• location.get, device.info, device.status
• stt.transcribe, tts.speak

โหมดโหนดต้องจับคู่กับ Gateway หากแอปแสดงคำขอจับคู่ ให้อนุมัติ จากโฮสต์ Gateway:

openclaw devices listopenclaw devices approve <request-id>openclaw nodes status

Gateway จะส่งต่อเฉพาะคำสั่งที่โหนดประกาศและนโยบายเซิร์ฟเวอร์อนุญาตเท่านั้น คำสั่งที่อ่อนไหวต่อความเป็นส่วนตัว เช่น screen.record, camera.snap และ camera.clip ต้องเลือกยินยอม gateway.nodes.allowCommands อย่างชัดเจน

โหมด MCP ภายในเครื่อง

Windows Hub สามารถเปิดเผยรีจิสทรีความสามารถแบบเนทีฟของ Windows เดียวกันเป็นเซิร์ฟเวอร์ MCP ภายในเครื่องบน local loopback ได้ สิ่งนี้มีประโยชน์เมื่อคุณต้องการให้ไคลเอนต์ MCP ภายในเครื่องขับเคลื่อน ความสามารถของ Windows โดยไม่ต้องมี OpenClaw Gateway ที่กำลังทำงาน

เปิดใช้งานได้ใน Settings ของ Windows Hub ใต้ส่วน developer/advanced แอปจะ แสดงปลายทาง local loopback และ bearer token หลังจากเปิดใช้งานเซิร์ฟเวอร์แล้ว

เมทริกซ์โหมด:

Windows CLI และ Gateway แบบเนทีฟ

สำหรับการใช้งานที่เน้นเทอร์มินัลก่อน ให้ติดตั้ง OpenClaw จาก PowerShell:

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

ตรวจสอบ:

openclaw --versionopenclaw doctoropenclaw gateway status --json

โฟลว์ Windows CLI และ Gateway แบบเนทีฟได้รับการรองรับและยังคงพัฒนาอย่างต่อเนื่อง การเริ่มต้นที่จัดการไว้ใช้ Windows Scheduled Tasks เมื่อพร้อมใช้งาน งานจะเก็บสคริปต์ gateway.cmd ที่อ่านได้ไว้ในไดเรกทอรีสถานะ OpenClaw แต่เปิดใช้งานผ่าน ตัวครอบ WScript gateway.vbs ที่สร้างขึ้น เพื่อให้ Gateway ที่ทำงานเบื้องหลังไม่เปิด หน้าต่างคอนโซลที่มองเห็นได้ หากการสร้างงานถูกปฏิเสธ OpenClaw จะถอยกลับไปใช้ รายการเข้าสู่ระบบในโฟลเดอร์ Startup สำหรับผู้ใช้แต่ละคน

หากต้องการติดตั้งบริการ Gateway:

openclaw gateway installopenclaw gateway status --json

หากคุณต้องการใช้เฉพาะ CLI โดยไม่มีบริการ Gateway ที่จัดการไว้:

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

WSL2 Gateway

WSL2 ยังคงเป็นรันไทม์ Gateway บน Windows ที่เข้ากันได้กับ Linux มากที่สุด Windows Hub สามารถตั้งค่า WSL Gateway ที่แอปเป็นเจ้าของให้คุณได้ หรือคุณจะติดตั้งเองภายใน ดิสโทรของคุณก็ได้

การตั้งค่าด้วยตนเอง:

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

เปิดใช้งาน systemd ภายใน WSL:

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

รีสตาร์ต WSL จาก PowerShell:

wsl --shutdown

จากนั้นติดตั้ง OpenClaw ภายใน WSL ด้วย Linux quickstart:

curl -fsSL https://openclaw.ai/install.sh | bashopenclaw gateway status

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

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

ภายใน WSL:

sudo apt-get install -y dbus-x11sudo loginctl enable-linger "$(whoami)"openclaw gateway install

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

schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec dbus-launch true" /sc onstart /ru "$env:USERNAME"

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

wsl --list --verbose

หมายเหตุ: มีการเปลี่ยนแปลงสองอย่างจากสูตรรุ่นเก่า:

• dbus-launch true แทน /bin/true — ใน WSL ≥ 2.6.1.0 มี regression (microsoft/WSL #13416) ที่ทำให้ดิสโทรยุติตัวเองเมื่อ idle หลังจากไคลเอนต์สุดท้ายออกไป 15–20 วินาที แม้เปิด linger แล้วก็ตาม dbus-launch true ทำให้กระบวนการ child-of-init ยังทำงานอยู่เป็นวิธีแก้ปัญหาชั่วคราว (การสนทนาในชุมชน, microsoft/WSL #9245)
• /ru "$env:USERNAME" แทน /ru SYSTEM — ดิสโทร WSL แบบรายผู้ใช้ (การตั้งค่าเริ่มต้น) ไม่ปรากฏต่อบัญชี SYSTEM งานจะดูเหมือนทำงาน แต่ดิสโทรจะไม่ถูกเริ่มเลย การรันในบัญชีของคุณเองช่วยหลีกเลี่ยงปัญหานี้ Windows จะถามรหัสผ่านของคุณเมื่อสร้างงาน

หลังรีบูต ให้ตรวจสอบจาก WSL:

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

เปิดเผยบริการ WSL ผ่าน LAN

WSL มีเครือข่ายเสมือนของตัวเอง หากเครื่องอื่นต้องเข้าถึงบริการภายใน WSL ให้ส่งต่อพอร์ต 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 New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `  -Protocol TCP -LocalPort $ListenPort -Action Allow

หมายเหตุ:

• SSH จากเครื่องอื่นจะชี้ไปที่ IP ของโฮสต์ Windows เช่น ssh user@windows-host -p 2222
• โหนดระยะไกลต้องชี้ไปที่ URL ของ Gateway ที่เข้าถึงได้ ไม่ใช่ 127.0.0.1
• ใช้ listenaddress=0.0.0.0 สำหรับการเข้าถึงผ่าน LAN ใช้ 127.0.0.1 สำหรับการเข้าถึง เฉพาะภายในเครื่อง

การแก้ไขปัญหา

ไอคอนในถาดระบบไม่ปรากฏ

ตรวจสอบ Task Manager สำหรับ OpenClaw.Tray.WinUI.exe หากกำลังทำงานอยู่ ให้เปิดพื้นที่ ไอคอนถาดระบบที่ซ่อนอยู่และปักหมุดไว้ หากไม่ได้ทำงาน ให้เปิด OpenClaw Companion จากเมนู Start

การตั้งค่าภายในเครื่องล้มเหลว

เปิดบันทึกการตั้งค่าจาก Windows Hub หรือตรวจสอบ:

notepad "$env:LOCALAPPDATA\OpenClawTray\Logs\Setup\easy-setup-latest.txt"

สาเหตุทั่วไปคือ WSL ถูกปิดใช้งาน การจำลองเสมือนถูกบล็อก สถานะ WSL ที่แอปเป็นเจ้าของค้างอยู่ หรือเครือข่ายล้มเหลวระหว่างติดตั้งแพ็กเกจ Gateway

แอปแจ้งว่าต้องจับคู่

อนุมัติคำขอโอเปอเรเตอร์หรือโหนดจาก Gateway:

openclaw devices listopenclaw devices approve <request-id>

หากอุปกรณ์มีโทเค็นอยู่แล้ว ให้เชื่อมต่อใหม่จากแท็บ Connections หลัง อนุมัติ

เว็บแชตเข้าถึง Gateway ระยะไกลไม่ได้

เว็บแชตระยะไกลต้องใช้ HTTPS หรือ localhost สำหรับใบรับรองที่ลงนามเอง ให้เชื่อถือ ใบรับรองใน Windows หรือใช้ SSH tunnel ไปยัง URL localhost

คำสั่ง screen.snapshot, กล้อง หรือเสียงล้มเหลว

ยืนยันสิทธิ์ของ Windows สำหรับกล้อง ไมโครโฟน การจับภาพหน้าจอ และ การแจ้งเตือน การติดตั้งแบบแพ็กเกจจะประกาศความสามารถที่ได้รับการป้องกันไว้แล้ว แต่ Windows อาจยังแจ้งเตือนในครั้งแรกที่คำสั่งใช้ความสามารถเหล่านั้น

การเชื่อมต่อ Git หรือ GitHub ล้มเหลว

บางเครือข่ายบล็อกหรือจำกัดความเร็ว HTTPS ไปยัง GitHub หาก git clone หรือ gh auth login ล้มเหลว ให้ลองเครือข่ายอื่น VPN หรือพร็อกซี HTTP/HTTPS

สำหรับการยืนยันตัวตน gh ด้วยโทเค็นในเซสชันปัจจุบัน:

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

ห้าม commit โทเค็นหรือวางโทเค็นลงใน issue หรือ pull request

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

• ภาพรวมการติดตั้ง
• การตั้งค่า Node.js
• โหนด
• Control UI
• การกำหนดค่า Gateway