OpenClaw 2026.5.22 릴리즈: WSL2 UNC 설치 shim 처리, Codex appServer.args 안내, Windows-safe npm shim 사용

OpenClaw 2026.5.22 릴리즈는 공식 X 포스트가 언급한 변경점을 먼저 보고, 세부 내용은 GitHub 릴리즈 노트와 연결해 읽는 편이 낫다. GitHub 릴리즈 노트에 Highlights가 없어서 Changes 항목을 중심으로 다시 묶었다.

공식 핵심 변경점

선정 기준은 @openclaw 공식 X 포스트다. 각 항목은 GitHub 릴리즈 노트의 원문 항목과 대조해 다시 풀었다.

WSL2 UNC 설치 shim 처리

무엇이 바뀌었나: Windows installer가 Windows-local directory에서 npm과 Corepack command shim을 실행한다.
왜 중요한가: 운영 영역에서 실제 설정, 자동화, 운영 흐름에 닿는 변경이다.
확인할 점: 업데이트 뒤 이 항목과 연결된 설정값, 채널 동작, 크론 실행 결과를 한 번 확인한다. 근거: Fixes #112

Codex appServer.args 안내

무엇이 바뀌었나: Codex app-server가 Node나 package-manager 인수를 포함한 command override를 거부하고 appServer.args를 안내한다.
왜 중요한가: 운영 영역에서 실제 설정, 자동화, 운영 흐름에 닿는 변경이다.
확인할 점: 업데이트 뒤 이 항목과 연결된 설정값, 채널 동작, 크론 실행 결과를 한 번 확인한다. 근거: Fixes #129

Windows-safe npm shim 사용

무엇이 바뀌었나: Release/package 검증을 Windows-safe npm command shim으로 실행해 native Windows check가 npm.cmd를 실행할 수 있게 했다.
왜 중요한가: 운영 영역에서 실제 설정, 자동화, 운영 흐름에 닿는 변경이다.
확인할 점: 업데이트 뒤 이 항목과 연결된 설정값, 채널 동작, 크론 실행 결과를 한 번 확인한다. 근거: Fixes #24

portable Git PATH 보존

무엇이 바뀌었나: Windows installer가 user-local portable Git을 PATH에 유지하고 repo-pinned pnpm version을 활성화한다.
왜 중요한가: 운영 영역에서 실제 설정, 자동화, 운영 흐름에 닿는 변경이다.
확인할 점: 업데이트 뒤 이 항목과 연결된 설정값, 채널 동작, 크론 실행 결과를 한 번 확인한다. 근거: Fixes #114

 

Changes 중심 요약

Gateway 채널 카탈로그 재사용: Gateway 성능 경로에서 채널 카탈로그 읽기를 재사용하고 CPU 프로파일 산출물이 무한히 쌓이지 않게 회전한다. 근거: Changes #1

플러그인 메타데이터 스냅샷 재사용: 시작, 설정, 모델, 채널 등의 메타데이터 리더가 불변 플러그인 메타데이터 스냅샷을 재사용한다. 근거: Changes #2

Gateway 유휴 작업 지연 로드: Gateway 상태와 준비 신호가 사용하지 않는 핸들러 트리나 ACPX 프로브를 기다리지 않도록 관련 작업을 지연 로드한다. 근거: Changes #3

외부 회의록 플러그인 추가: 코어 npm 패키지 밖에 source-only 외부 meeting-notes 플러그인과 SDK source-provider 계약을 추가한다. 근거: Changes #5

모델 사용 문서 명확화: 모델 사용 이식성, Codex 마이그레이션 전제 조건, hook 소유권과 설정 보존 안전 지침을 명확히 했다. 근거: Changes #7

 

운영 관점에서 볼 점

Gateway 채널 카탈로그 재사용: Gateway 성능 경로에서 채널 카탈로그 읽기를 재사용하고 CPU 프로파일 산출물이 무한히 쌓이지 않게 회전한다. 근거: Changes #1

플러그인 메타데이터 스냅샷 재사용: 시작, 설정, 모델, 채널 등의 메타데이터 리더가 불변 플러그인 메타데이터 스냅샷을 재사용한다. 근거: Changes #2

Gateway 유휴 작업 지연 로드: Gateway 상태와 준비 신호가 사용하지 않는 핸들러 트리나 ACPX 프로브를 기다리지 않도록 관련 작업을 지연 로드한다. 근거: Changes #3

 

업그레이드

npm install -g openclaw@latest
openclaw --version

자동화, 채널, 플러그인, Gateway 운영 경로처럼 실제 운영에 닿는 항목이 포함된 릴리즈라면 업데이트 뒤 채널 연결과 크론 동작을 한 번 확인하는 편이 안전하다.

 

요약

영역	핵심 포인트
운영	WSL2 UNC 설치 shim 처리 - Windows installer가 Windows-local directory에서 npm과 Corepack command shim을 실행한다.
운영	Codex appServer.args 안내 - Codex app-server가 Node나 package-manager 인수를 포함한 command override를 거부하고 appServer.args를 안내한다.
운영	Windows-safe npm shim 사용 - Release/package 검증을 Windows-safe npm command shim으로 실행해 native Windows check가 npm.cmd를 실행할 수 있게 했다.
운영	portable Git PATH 보존 - Windows installer가 user-local portable Git을 PATH에 유지하고 repo-pinned pnpm version을 활성화한다.

 

릴리즈 노트

https://github.com/openclaw/openclaw/releases/tag/v2026.5.22

Release openclaw 2026.5.22 · openclaw/openclaw