OpenClaw 2026.5.2 릴리즈는 외부 플러그인 설치 경로, Gateway와 agent 런타임 경량화, 채널·provider 안정성 개선을 중심으로 읽을 수 있다. 아래 내용은 GitHub 릴리즈 노트의 Highlights, Changes, Fixes 항목을 기준으로 다시 묶었다.
핵심 3가지
외부 플러그인 설치 경로 강화: npm-first 전환 과정에서 외부 플러그인 설치, 업데이트, doctor repair, dependency reporting, artifact metadata 처리 경로가 보강됐다.
Gateway·agent hot path 경량화: startup, session listing, task maintenance, prompt prep, plugin loading, tool descriptor planning, filesystem guard 같은 자주 타는 경로의 불필요한 작업이 줄었다.
채널·provider 안정성 개선: WhatsApp, Telegram, Discord, Slack, Signal 같은 메시징 경로와 OpenAI-compatible TTS/Realtime, OpenRouter/DeepSeek replay, Anthropic-compatible streaming, web search, media path가 함께 보강됐다.
Highlights 전체 요약
외부 플러그인 설치 경로 강화
npm-first cutover, stale configured installs, missing package payloads, beta-channel plugin fallback 같은 상황을 다루도록 외부 플러그인 설치·업데이트·doctor repair·dependency reporting·artifact metadata 흐름이 확장됐다. 근거: Highlights #1
Gateway·agent hot path 경량화
Gateway startup, session listing, task maintenance, prompt prep, plugin loading, tool descriptor planning, filesystem guard, large runtime config 처리에서 필요 없는 preload와 반복 계산을 줄였다. 근거: Highlights #2
Control UI와 WebChat 복원력 개선
Sessions, Cron, long-running Gateway WebSocket, grouped-message width, slash-command feedback, iOS PWA bounds, selection contrast, Talk diagnostics 쪽 UI/운영 edge case가 다듬어졌다. 근거: Highlights #3
메시징 채널 안정성 보강
WhatsApp Channel/Newsletter target, Telegram topic command와 networking, Discord delivery/startup edge case, Slack thread, Signal group/media, visible reply routing이 함께 수정됐다. 근거: Highlights #4
Provider와 media 경로 수정
OpenAI-compatible TTS/Realtime, OpenRouter/DeepSeek replay, Anthropic-compatible streaming, LM Studio reasoning metadata, Brave/SearXNG/Firecrawl web search, media path, music, voice-call routing 관련 문제가 정리됐다. 근거: Highlights #5
주요 변경사항
Gateway restart 제어 강화: startup secrets preflight에서 plugin-backed auth-profile overlay를 건너뛰어 readiness latency를 줄이고, `openclaw gateway restart --force`, `--wait`, active task run ID logging, timeout restart reporting을 추가했다. 근거: Changes #1
ClawHub install metadata 보존: diagnostics, onboarding, doctor repair, channel setup이 ClawPack metadata를 install record까지 이어가도록 바뀌었다. 명시적 `clawhub:` install은 ClawHub에 남기고, bare package install은 npm 기본 경로를 유지한다. 근거: Changes #2
plugin dependency 상태 노출: `openclaw plugins list --json`에 package dependency install state가 포함되어, runtime load 전에 빠진 plugin dependency를 스크립트에서 확인할 수 있다. 근거: Changes #3
plugin runtime preload 범위 축소: 모든 discoverable plugin을 미리 import하지 않고, config·startup planning·configured channels·slots·auto-enable rules에서 실제 effective plugin id를 계산해 preload 범위를 줄인다. 근거: Changes #5
tool descriptor planning 개선: descriptor-first visibility와 generic availability check, executor reference를 위한 platform-level tool descriptor planner가 추가됐다. plugin tool descriptor도 cache해 prompt-time planning이 반복 runtime loading을 피할 수 있게 됐다. 근거: Changes #8
운영 관점에서 볼 점
업데이트·플러그인 복구 경로: beta channel plugin fallback, missing package payload repair, artifact metadata 기록이 보강되어 외부 플러그인 전환기에 깨지기 쉬운 설치 상태를 더 잘 추적할 수 있다.
대형 config와 startup 비용: plugin registry 재사용, descriptor cache, path guard fast path 같은 변경은 Gateway가 많은 channel/provider/tool 설정을 가진 환경에서 체감될 수 있다.
채널 연결 검증: WhatsApp, Telegram, Discord, Slack, Signal 관련 수정이 많으므로 업데이트 뒤 실제 inbound/outbound reply, thread, media, visible reply routing을 한 번 확인하는 편이 안전하다.
보안과 버그 수정
이번 릴리즈의 수정사항은 아래 항목들을 중심으로 보면 된다.
GPT-5 API-key session 응답 복구: OpenAI API-key session에서 WebSocket을 명시하지 않은 경우 SSE Responses transport를 기본으로 사용해, fresh Control UI/WebChat beta 환경에서 응답이 오지 않던 문제를 줄였다. 근거: Fixes #1
session lifecycle 상태 보존: stale in-memory snapshot에서 final run metadata가 persist될 때 terminal lifecycle state를 보존해, 완료되거나 timeout된 session이 계속 running으로 남는 문제를 막았다. 근거: Fixes #2
Gateway start 복구 안내 강화: stale managed service definition, 오래된 OpenClaw version, missing binary, temporary installer path를 gateway start 전에 repair하고, probe 실패 시 service/config/listener/log 확인 단계를 더 구체적으로 안내한다. 근거: Fixes #3
plugin update/config 복구 강화: 사라진 package directory, stable runtime alias, beta external plugin install, configured web-search provider 검증 등을 보강해 plugin install record와 실제 disk payload가 어긋난 상황을 더 빨리 잡는다. 근거: Fixes #4
업그레이드
npm install -g openclaw@latest
openclaw --version이번 릴리즈는 플러그인 설치·업데이트, Gateway startup, 채널 reply/delivery, provider/media 경로처럼 운영 중 바로 닿는 부분이 많다. 업데이트 뒤에는 `openclaw status`, `openclaw doctor --fix`, 실제 채널 reply 테스트를 짧게 확인하는 쪽이 좋다.
요약
| 영역 | 핵심 포인트 |
|---|---|
| 플러그인 | 외부 플러그인 설치·업데이트·복구·metadata 기록 경로가 npm-first 전환에 맞춰 보강됐다. |
| 성능 | Gateway와 agent hot path에서 preload, descriptor planning, path guard, config hashing 비용을 줄였다. |
| 채널 | WhatsApp, Telegram, Discord, Slack, Signal, visible reply routing 관련 edge case가 다수 수정됐다. |
릴리즈 노트
https://github.com/openclaw/openclaw/releases/tag/v2026.5.2
Release openclaw 2026.5.2 · openclaw/openclaw
Highlights External plugin installation, update, doctor repair, dependency reporting, and artifact metadata now cover the npm-first cutover, stale configured installs, missing package payloads, an...
github.com
