AI / 자동화
2026년 6월 1일
한 줄 openclaw onboard: Windows WSL2에서 10분 설정
VpsGona 팀
2026년 6월 1일
~12분
Windows WSL2에서 openclaw onboard 약 10분. 공식 문서. 배포, Ollama, 부트스트랩, 헤드리스.
고지: VpsGona 선택적 Mac 렌탈.
onboard 이유
openclaw onboard --install-daemon → systemd. ~/.openclaw/.
WSL2 vs 네이티브
| Path | Command | Service | Use |
|---|---|---|---|
| WSL2 (recommended) | openclaw onboard --install-daemon | systemd user service | Full wizard + Linux tools |
| Native Windows | openclaw onboard | Scheduled Task / Startup | Quick CLI test |
| Native skip-health | openclaw onboard --non-interactive --skip-health | openclaw gateway run | When health blocks first run |
사전 요구
- WSL2, Node 22+, API 키
8단계
wsl --install- Ubuntu 업데이트
- Node 설치
- install.sh
openclaw onboard --install-daemon- 마법사
- Dashboard
- 상태 확인
마법사
모델, 게이트웨이, 채널(선택), Skills.
문제 해결
Dashboard 타임아웃
portproxy로 PORT 전달.
헬스 실패
--skip-health.
다음
FAQ
What does openclaw onboard do?
It runs an interactive wizard that writes config under ~/.openclaw/, starts the gateway, and prints a dashboard URL.
Should I use --install-daemon?
Yes inside WSL2 for a systemd background service. Native Windows uses Scheduled Task fallbacks per official docs.
How long does setup take?
About 10 minutes after WSL2 and Node are ready; first wsl --install needs a reboot.
Can I skip Telegram/Slack in the wizard?
Yes—skip channels and run openclaw configure later.
Dashboard URL fails in Windows browser?
Use netsh portproxy to forward the WSL port to Windows localhost.