Windows

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

WSL2 (แนะนำ)

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

​

สถานะ 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 ยังคงเป็นตัวเลือกที่ต้องการเมื่อใช้งานได้ เพราะให้สถานะตัวควบคุมบริการที่ดีกว่า

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

openclaw gateway install
openclaw gateway status --json

​

Gateway

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

​

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

openclaw onboard --install-daemon

openclaw gateway install

openclaw configure

openclaw doctor

​

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

​

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

sudo loginctl enable-linger "$(whoami)"

​

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

openclaw gateway install

​

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

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

wsl --list --verbose

​

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

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

​

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

$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

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

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

​

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

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

wsl --shutdown

systemctl --user status

​

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

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

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

​

แอปคู่หู Windows

​

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

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

​

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

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