Windows/WSL2에 OpenClaw를 넣을 때 흔한 다섯 가지 오독 서명
OpenClaw 2026 설치면은 macOS, Linux, Windows(대개 WSL2 경유)를 포괄합니다. Windows 쪽 장애는 세 층이 겹치기 쉽습니다. Node 런타임 버전, systemd 사용자 세션 사용 가능 여부, 18789 유령 프로세스 점유입니다. 운영이 이를 「다시 설치」로 압축하면 2026.4.24 부근 빌드에서 30~50초마다 크래시 루프에 들어가고, 실제 막힘은 사용자·시스템 Gateway 서비스 이중 등록으로 남습니다. 변경 티켓에는 먼저 서명 번호를 붙이고, 포트 정리, dist-tag 롤백, 프로덕션 Gateway 클라우드 Mac 이전 중 무엇을 택할지 정하십시오.
WSL에서 클라우드 Mac ping 성공 = Gateway 정상: 도달성과 openclaw gateway status active는 별개입니다. Node remote URL이 틀리면 Windows 로컬만 재시작을 반복합니다.
WSL2 systemd 없이 onboard --install-daemon: unit은 써지지만 user session에서 못 올려 SSH 끊기면 프로세스가 사라져 「가끔 끊김」처럼 보입니다.
Windows 호스트와 WSL 양쪽에 Gateway: 18789 이중 listen으로 유령 EADDRINUSE가 나고 doctor 출력이 모순됩니다.
노트북 절전 후 채널 침묵: 소비자 Windows 휴면은 WSL도 멈춥니다. 프로덕션 webhook은 잠들지 않는 클라우드 Mac Master에 두고 Windows는 Node나 콘솔만 씁니다.
업그레이드 후 config key 표류·doctor 미실행: 소버전을 넘어도 json에 옛 키가 남으면 Gateway는 뜨는데 channels probe가 빨갛고 Windows 방화벽 탓이 됩니다.
서명을 붙인 뒤 모델 라우팅을 만지십시오. 클라우드 Mac에서 Master를 이미 돌린다면 배선은 원격 Node 페어링과 리전 간 이전을 먼저 읽습니다. 클라우드에서 Gateway를 한 번도 수용하지 않았다면 헤드리스 SSH 첫 한 시간 체크리스트로 바닥을 고른 다음 WSL 상시를 얹으십시오. 불안정한 Master 위에 로컬 재시작 소음을 더하면 분리가 더 어려워집니다.
Windows 네이티브, WSL2, 「클라우드 Mac Gateway」 삼분법 매트릭스
2026 커뮤니티 합의는 「Windows에서 OpenClaw 불가」가 아니라 7×24 제어 평면과 채널 webhook을 안정 호스트에 두는 것입니다. 아래 표는 로컬 실험, WSL 개발기 자체 Gateway, 「클라우드 Mac Master + Windows Node」 분리 토폴로지를 거칠게 맞춥니다. 분리 구성 보완으로 Gateway 전 플랫폼 배포와 복구를 참고하십시오.
| 관점 | Windows 네이티브 | WSL2 + systemd | 클라우드 Mac Gateway + Win Node |
|---|---|---|---|
| 설치 입구 | install.ps1 | install.sh(Ubuntu 내) | 클라우드 Mac: install.sh; Win: CLI/Node만 |
| 상시 형태 | 작업 스케줄러, UI 간섭 | 사용자 systemd unit | 클라우드 Mac: LaunchAgent; Win: 상시 없음 가능 |
| 7×24 채널 | 절전·업데이트로 끊김 | WSL 일시 중지 시 단절 | 채널은 클라우드 Mac만, 가장 안정 |
| 분리 난이도 | 경로·권한 분열 | systemd·포트 이해 필요 | Win은 Node, 클라우드 Mac은 Gateway로 층 분리 |
| 2026 권장 | 단기 데모 | 프로덕션 스크립트 재현 | 멀티 리전 소팀, 자동화 담당 |
프로덕션 채널은 노트북이 안 잔다고 걸지 마십시오. Gateway는 클라우드 Mac loopback에 두고 Windows는 node run만 돌리십시오.
분리 토폴로지를 고르면 어떤 클라우드 Mac이 webhook을 받고 Windows가 openclaw node run --remote wss://...만 하는지 문서화하십시오. 실험 기간 WSL에 임시 Gateway를 세우는 것은 괜찮지만 같은 채널 token을 클라우드 Mac Master와 동시에 꽂지 마십시오. 이중 소비와 메시지 유실이 납니다. Docker와 베어메탈 차이는 Docker와 install.sh 이중 경로, 버전 고정은 업그레이드·롤백 Runbook을 보십시오.
WSL2 사전 점검, Node 24 수용, 「유령 EADDRINUSE」 층별 대응
WSL에서 프로덕션급 openclaw onboard --install-daemon 전에 Node ≥ 22.16(권장 24)과 systemd=true를 확인하십시오. 2026년 4월 말 일부 2026.4.24 빌드는 Gateway 로그는 뜨는데 Control UI가 안 닿고 30~50초 주기 EADDRINUSE가 보고되었습니다. 완화 중 하나는 2026.4.22 고정과 중복 systemd unit 정리입니다. 다음 명령 블록은 당번 골격이며 배포판 경로는 환경에 맞게 바꾸십시오.
grep -q 'systemd=true' /etc/wsl.conf || echo '[boot]' >> /etc/wsl.conf && echo 'systemd=true' >> /etc/wsl.conf node -v curl -fsSL https://openclaw.ai/install.sh | bash openclaw onboard --install-daemon systemctl --user status openclaw-gateway lsof -i :18789 openclaw doctor openclaw gateway status
lsof에서 18789가 잡혀 있는데 gateway status가 stopped면 잔류 openclaw 프로세스와 /etc/systemd/system·~/.config/systemd/user 이중 unit을 먼저 의심하십시오. 정리 후 사용자 unit만 남기고 systemctl --user daemon-reload로 재기동합니다. 여전히 루프면 openclaw --version을 기록하고 Runbook에 따라 2026.4.24 롤백을 검토한 뒤 변경 창에 openclaw doctor --fix를 실행하십시오. Windows 호스트 방화벽으로 Control UI를 로컬 확인할 때도 프로덕션은 Tailscale Serve로 클라우드 Mac Master를 가리키고 노트북 포트를 공인망에 노출하지 않는 편이 안전합니다.
기록: onboard 전후로 systemctl --user status와 lsof -i :18789를 각각 한 번 아카이브하면 「이중 인스턴스」와 「버전 결함」 분리가 쉬워집니다.
여섯 단계 Runbook: WSL 수용에서 클라우드 Mac Master 채널 스모크까지
토폴로지 고정: Win 역할(Node만/임시 Gateway), 클라우드 Mac 도시, 채널을 Master만에 둘지 기록합니다.
WSL 사전: systemd 활성화, node -v ≥ 22.16 확인. 필요 시 Ubuntu 안에 Node 24를 별도 설치합니다.
클라우드 Mac Master 배포: 첫 한 시간 체크리스트대로 install.sh, onboard, LaunchAgent. loopback 18789와 gateway status를 확인합니다.
Win/WSL remote 연결: node run --remote 또는 Control UI를 Master WSS로. 1008이면 Master에서 devices approve(원격 Node 글 참고).
분리 구성이면 Win 로컬 Gateway 중지: WSL 사용자 unit을 멈춰 Master와 같은 채널 설정을 다투지 않습니다.
Master 채널 스모크: 클라우드 Mac에서 channels probe와 실제 inbound. Win은 도구 실행만 보고 webhook을 노트북으로 되돌리지 않습니다.
세 가지 당번 임계값과 여섯 리전 클라우드 Mac Gateway 선정
포트 경합 적색선: 같은 WSL에서 10분에 EADDRINUSE 3회 이상이고 openclaw-gateway 프로세스가 2개 이상이면 이중 인스턴스로 보고 중지·정리를 먼저 합니다.
Node 버전 하한: 2026 공식 문서는 Node 24를 권장 기준으로 둡니다. 22.16 미만이면 doctor는 통과해도 플러그인 로드가 불안정합니다. 티켓에 node -v 증적을 붙이십시오.
분리 토폴로지 수용: Master 복구 후 10분 안에 channels probe 3회 이상. Win을 한 번 절전시켜도 Node만 재연결하고 채널은 노트북 상시 온라인에 의존하지 않아야 합니다.
주의:임계값은 당번 소통용 기준이며 벤더 SLA가 아닙니다.
Gateway를 Windows 노트북에 묶으면 절전, 자동 업데이트 재시작, WSL 동결이 돌아옵니다. 값싼 Linux VPS만으로는 macOS 브라우저 자동화·공증 체인 도구에서 멀어집니다. 베어메탈 클라우드 Mac을 Master, Windows를 Node나 콘솔로 두면 Apple 툴체인 근접, loopback 규율, 예측 가능한 교체 창 균형이 맞습니다. 7×24 채널을 소비자 하드 상시 온라인에 걸기 싫은 팀에는 MESHLAUNCH Mac Mini 클라우드 대여가 현실적입니다. 목표 리전에서 일 단위 대여로 여섯 단계와 호스트 재부팅을 한 번 통과한 뒤 상태가 굳으면 월 단위로 잠그는 순서를 권합니다. 용량·신청은 대여 요금과 고객 센터를 보십시오.
먼저 lsof -i :18789와 systemctl --user status openclaw-gateway로 이중 unit·잔류 프로세스를 정리하고 2026.4.24 고정 필요 여부를 봅니다. 전 플랫폼 Gateway 절차, 신청은 요금 페이지입니다.
단기 실험에는 충분합니다. 프로덕션 채널은 클라우드 Mac Master로 옮기고 Win은 node run만 쓰는 편이 안전합니다. 배포는 헤드리스 SSH 첫 한 시간 체크리스트를 참고하십시오.
/etc/wsl.conf의 systemd가 여전히 true인지, openclaw doctor 결과를 확인하십시오. 분리 토폴로지에서는 채널이 클라우드 Mac에서 온라인이어야 합니다. 절차는 고객 센터입니다.