Files
Obsidian/claws_en/Running OpenClaw in Docker on Windows via WSL.md
T
coco 8b94d76799 a
2026-07-21 13:57:15 +08:00

69 lines
3.1 KiB
Markdown

### 这个教程是Grox帮我生成的
### 其他的教材包括
https://xaicontrol.com/en/blog/openclaw-windows-xai-router/
https://til.simonwillison.net/llms/openclaw-docker
https://docs.openclaw.ai/install/docker
Running OpenClaw in Docker on Windows via WSL is one of the most reliable & recommended ways in 2026 (avoids many native Windows path/node-gyp/build issues).Here are the two most common & working approaches right now:Recommended Method: Use official repo + Docker Desktop + WSL (easiest & officially supported)Prerequisites
1. Install Docker Desktop for Windows [(https://www.docker.com/products/docker-desktop/)](https://www.docker.com/products/docker-desktop/)
- During installation → check "Use WSL 2 instead of Hyper-V" (almost always selected by default now)
- Finish install & let it start
2. Make sure WSL2 is enabled & you have an Ubuntu distro
- Open PowerShell (admin) → wsl --install -d Ubuntu (if not already installed)
- Or just open Ubuntu from Start menu
3. In Docker Desktop settings → Resources → WSL Integration → enable your Ubuntu distro
Steps in Ubuntu (WSL terminal)
bash
```bash
# 1. Update & install git + curl if needed
sudo apt update && sudo apt install -y git curl
# 2. Clone the official repo
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 3. (optional but recommended) Make sure you have the latest image name
export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
# 4. Run their official Docker helper script
# → this creates volumes, pulls images, starts docker-compose
./scripts/docker/setup.sh
```
- The script will:
- Create ~/.openclaw folder (on Linux filesystem = fast & reliable)
- Start gateway + cli containers via docker-compose
- Walk you through first-time onboarding (API keys, LLM provider, etc.)
- After it finishes → open browser → [http://localhost:18789](http://localhost:18789) (or whatever port it shows)
Tips / Common fixes
- If pairing / pending.json error → stop containers, delete ~/.openclaw/gateway/pending.json, restart
- Want to stop? → docker compose down
- Want to update? → git pull then ./scripts/docker/setup.sh again
- GPU? → Docker Desktop already exposes NVIDIA/AMD/Intel GPU to WSL if drivers are installed
Alternative: Quick & dirty single-container (third-party maintained)If you just want to test fast without cloning repo:
bash
```bash
# Create persistent folders (important!)
mkdir -p ~/.openclaw/workspace
docker run -d --name openclaw-gateway \
-p 18789:18789 \
-v ~/.openclaw:/home/node/.openclaw \
-v ~/.openclaw/workspace:/home/node/.openclaw/workspace \
--restart unless-stopped \
ghcr.io/openclaw/openclaw:latest \
gateway start
```
Then go to [http://localhost:18789](http://localhost:18789) and do onboarding.But the official ./scripts/docker/setup.sh method is better long-term because it handles docker-compose + CLI container + updates more nicely.Pick whichever you prefer — both work fine in WSL2 + Docker Desktop in 2026.Good luck & enjoy your lobster-powered assistant ![🦞](https://abs-0.twimg.com/emoji/v2/svg/1f99e.svg "Lobster")