OpenClaw v2026.5.2 업데이트 작업일지

OpenClaw v2026.5.2 업데이트 작업일지

[!note] 수정이력 | 2026-05-03 12:45, 루키 (hermes)

업데이트 개요

• 이전 버전: v2026.4.29
• 업데이트 버전: v2026.5.2
• 대상 노드: 맥미니, 분홍(메인컴 WSL), 하늘(보조컴 WSL)

결과

노드	버전	게이트웨이 상태
🖥️ 맥미니 (m4pro-64g-2)	v2026.5.2 ✅	local 게이트웨이 정상 (health OK)
🖥️ 분홍 (mainpc-wsl)	v2026.5.2 ✅	remote 연결 OK
🖥️ 하늘 (subpc-wsl)	v2026.5.2 ✅	remote 연결 OK

발생 이슈 및 해결

1. 하늘 local 게이트웨이 충돌 (exit code 78)

• 원인: 하늘은 remote 모드(맥미니 게이트웨이에 연결)로 운영되는데, 업데이트 후 local 게이트웨이 systemd 서비스가 자동 시작되면서 Gateway start blocked: set gateway.mode=local 에러로 exit 78 발생
• 해결: systemctl --user disable openclaw-gateway.service + stop으로 로컬 게이트웨이 비활성화
• 참고: remote 모드 노드는 로컬 게이트웨이 서비스가 불필요

2. NODE_OPTIONS 복구 (Telegram IPv6 이슈)

• 원인: openclaw update 실행 시 LaunchAgent plist가 재생성되면서 NODE_OPTIONS=--dns-result-order=ipv4first 설정이 삭제됨
• 해결: PlistBuddy로 재설정 후 LaunchAgent 리로드
• 명령어:

  /usr/libexec/PlistBuddy -c "Add :EnvironmentVariables dict" ~/Library/LaunchAgents/ai.openclaw.gateway.plist 2>/dev/null
  /usr/libexec/PlistBuddy -c "Add :EnvironmentVariables:NODE_OPTIONS string --dns-result-order=ipv4first" ~/Library/LaunchAgents/ai.openclaw.gateway.plist 2>/dev/null
  launchctl unload ~/Library/LaunchAgents/ai.openclaw.gateway.plist 2>/dev/null
  launchctl load -w ~/Library/LaunchAgents/ai.openclaw.gateway.plist

3. Role upgrade 페어링 버그 (missing scope)

• 원인: 분홍과 하늘 모두 업데이트 후 node → operator role upgrade 요청 발생. openclaw devices approve CLI는 “missing scope: operator.read” 에러로 실패 (v2026.5.2도 미해결 버그)
• 해결: ~/.openclaw/devices/paired.json에서 해당 디바이스 항목의 roles, scopes, tokens를 직접 수정 후 게이트웨이 재시작
• 수정 내용:
  • roles: ["node"] → roles: ["node", "operator"]
  • role: "node" → role: "operator"
  • scopes/approvedScopes에 operator 전체 권한 추가
  • tokens에 operator 토큰 추가 (각 노드의 device-auth.json에서 가져옴)
• 재시작: launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway

4. WSL 노드 sudo 권한 필요

• 원인: openclaw update를 일반 계정으로 실행하면 EACCES: permission denied 발생 (글로벌 설치 경로 /usr/lib/node_modules/에 쓰기 권한 없음)
• 해결: sudo openclaw update --yes로 실행

노드 구성 정리

• 맥미니: local 게이트웨이 운영 (게이트웨이 역할)
• 분홍 (mainpc-wsl): remote 모드 → 맥미니 게이트웨이에 연결
• 하늘 (subpc-wsl): remote 모드 → 맥미니 게이트웨이에 연결, 로컬 게이트웨이 서비스 비활성화됨

업데이트 절차 체크리스트 (다음 업데이트 시 참고)

1. ✅ sudo openclaw update --yes (WSL 노드는 sudo 필요)
2. ✅ 맥미니: NODE_OPTIONS 복구 (plist 재생성 시마다 삭제됨)
3. ✅ 맥미니: LaunchAgent 리로드
4. ✅ remote 노드: role upgrade 페어링 요청 발생 시 paired.json 수동 수정
5. ✅ remote 노드: local 게이트웨이 서비스 비활성화 여부 확인
6. ✅ 전체 노드 openclaw health 로 연결 상태 확인