이번 릴리즈는 첫 설정 경험을 다듬는 사용자 경험 개선과, 운영자가 체감하는 안정화 수정이 같이 들어간 버전이다. 겉으로는 온보딩과 안내 문구가 더 읽기 쉬워졌고, 안쪽으로는 세션 저장소 정리와 크론 상태 관리, 모델 기본값 조정이 같이 이뤄졌다.
핵심 3가지
온보딩 경고 UI 개선: 설정 마법사 경고 구간을 한 화면에서 읽기 쉽게 다시 정리해 처음 쓰는 사용자도 핵심 주의를 빠르게 파악할 수 있게 했다.
기본 프롬프트 강화: 기본 시스템 프롬프트를 더 보수적으로 다듬어 성급한 완료, 약한 결과 제출, 상태 확인 누락을 줄이는 방향으로 보강했다.
운영 안정화와 모델 조정: 세션 저장소 정리, 크론 실행 상태 분리, Moonshot Kimi 기본 노출 조정까지 운영자가 바로 체감할 변경이 같이 들어갔다.
변경사항
설정 마법사와 첫 사용 경험
온보딩 구간은 이번 버전에서 가장 눈에 잘 띄는 변화다. 경고 배너와 체크리스트를 다시 묶고, 로딩 스피너와 입력 안내를 보강해서 처음 설정할 때 정보가 흩어져 보이던 문제를 줄였다. 특히 핵심 주의를 빠르게 훑을 수 있게 한 점이 실사용에서 체감될 가능성이 크다.
기본 프롬프트와 에이전트 동작
기본 프롬프트 계층도 더 단단하게 조정됐다. 완료를 너무 빨리 선언하는 습관, 현재 상태를 덜 확인한 채 답하는 흐름, 약한 결과를 그대로 제출하는 패턴을 줄이려는 의도가 분명하다. GPT-5 계열 기본 동작을 쓰는 사용자라면 이런 변화가 누적해서 품질 차이를 만든다.
세션, 크론, 모델 운영 안정화
운영 관점에서는 세션 저장소 정리와 크론 상태 관리가 중요하다. 세션 backlog가 쌓이면서 게이트웨이가 무거워지는 문제를 줄이고, 실행 상태 파일을 분리해 작업 정의와 런타임 상태를 덜 섞이게 만들었다. 여기에 Moonshot Kimi 기본 노출과 비용 추정 보강까지 더해져 실제 운영 감각이 더 안정적으로 바뀌었다.
보안 패치
보안 수정 비중도 높다. exec 경계, gateway/session key 처리, SSRF 차단, websocket broadcast 범위 같은 항목이 같이 손봐졌다. 공개 환경이나 팀 환경에서 OpenClaw를 돌리는 사용자라면 이번 버전은 기능 추가보다도 먼저 안정성 업데이트로 보는 편이 맞다.
특히 Image generation: log failed provider/model candidates at warn level before automatic provider fallback, so OpenAI image failures are visible in the gateway log even when a later provider succeeds 같은 수정은 바로 체감될 가능성이 크다.
버그 수정
세부 버그 수정도 범위가 넓다. 채널별 동작 차이, transport 선택, 비용 캐시, thinking 옵션 노출처럼 운영 중 자주 맞닥뜨리는 연결부를 많이 정리했다. 새 기능보다 기존 동작을 덜 삐걱거리게 만드는 쪽에 공이 많이 들어간 릴리즈다.
예를 들면 Plugins/doctor: repair bundled plugin runtime dependencies from doctor paths so packaged installs can recover missing channel/provider dependencies without broad core dependency installs 같은 수정이 포함됐다.
업그레이드
npm install -g openclaw@latest
openclaw --version이번 버전은 겉으로 보이는 UX 개선과 내부 운영 안정화가 같이 들어가 있다. 공개 환경이라면 보안 패치 이유만으로도 올릴 가치가 충분하고, 개인 환경이라도 크론과 세션 관련 수정 때문에 따라가는 편이 낫다.
요약
| 영역 | 핵심 포인트 |
|---|---|
| UX | 온보딩 경고 구간과 첫 설정 경험 정리 |
| 에이전트 | 기본 프롬프트와 검증 흐름 강화 |
| 운영 | 세션 저장소 정리와 크론 상태 분리 |
| 모델 | Moonshot Kimi 기본 노출 및 비용 추정 보강 |
| 보안 | exec, session key, SSRF, websocket 경계 보강 |
릴리즈 노트
https://github.com/openclaw/openclaw/releases/tag/v2026.4.21
Release openclaw 2026.4.21 · openclaw/openclaw
2026.4.21 Changes OpenAI/images: default the bundled image-generation provider and live media smoke tests to gpt-image-2, and advertise the newer 2K/4K OpenAI size hints in image-generation docs a...
github.com
