69 lines
3.1 KiB
Markdown
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  |