OpenClaw 2026.5.3 릴리즈는 file-transfer 플러그인 추가, Gateway lazy-loading 성능 개선, 채널 reply·delivery 복구 강화를 중심으로 읽을 수 있다. 아래 내용은 GitHub 릴리즈 노트의 Highlights, Changes, Fixes 항목을 기준으로 다시 묶었다.
핵심 3가지
file-transfer 플러그인 추가: paired node에서 바이너리 파일을 다루는 file-transfer 플러그인이 번들로 추가됐다. file_fetch, dir_list, dir_fetch, file_write 도구와 노드별 default-deny 경로 정책, symlink traversal 차단, 16MB 전송 한도가 함께 들어갔다.
Gateway lazy-loading 성능 개선: 플러그인·런타임 discovery, cron, schema, shutdown hook, session, model metadata 같은 Gateway 경로가 필요할 때 로드되도록 바뀌어 시작과 운영 부담이 줄었다.
채널 reply·delivery 복구 강화: Discord 상태 반응과 degraded transport 보고가 개선됐고, WhatsApp Channel/Newsletter 대상이 추가됐으며 Telegram, Feishu, Matrix, Microsoft Teams, Slack의 delivery/recovery 동작이 더 단단해졌다.
Highlights 전체 요약
file-transfer 플러그인 추가
paired node에서 바이너리 파일을 다루는 file-transfer 플러그인이 번들로 추가됐다. file_fetch, dir_list, dir_fetch, file_write 도구와 노드별 default-deny 경로 정책, symlink traversal 차단, 16MB 전송 한도가 함께 들어갔다. 근거: Highlights #1
공식 플러그인 설치 경로 강화
공식 플러그인의 설치, 제거, 업데이트, 온보딩, ClawHub fallback, npm dependency-state 보고, beta-channel 업데이트 경로가 더 안전하게 다듬어졌다. 근거: Highlights #2
Gateway lazy-loading 성능 개선
플러그인·런타임 discovery, cron, schema, shutdown hook, session, model metadata 같은 Gateway 경로가 필요할 때 로드되도록 바뀌어 시작과 운영 부담이 줄었다. 근거: Highlights #3
채널 reply·delivery 복구 강화
Discord 상태 반응과 degraded transport 보고가 개선됐고, WhatsApp Channel/Newsletter 대상이 추가됐으며 Telegram, Feishu, Matrix, Microsoft Teams, Slack의 delivery/recovery 동작이 더 단단해졌다. 근거: Highlights #4
설치·업데이트 복구 경로 강화
macOS LaunchAgent 업그레이드 복구, source-only 플러그인 패키지의 runtime load 전 거부, 업데이트와 doctor 실행 중 stale Gateway/plugin 상태 복구가 추가됐다. 근거: Highlights #5
에이전트 런타임 안정성 개선
스트리밍 provider 응답, 지연된 A2A 세션 응답, prompt/tool 전달, memory recall, web search provider discovery, provider별 thinking/model metadata가 흔한 edge case에서도 보존되도록 개선됐다. 근거: Highlights #6
주요 변경사항
/steer 명령 추가: 현재 세션의 active run에 새 turn을 만들지 않고 바로 steering 메시지를 보낼 수 있는 /steer 명령이 추가됐다. 근거: Changes #2
/side 질문 alias 추가: /btw side questions를 더 짧게 호출할 수 있도록 /side text 명령과 native slash-command alias가 추가됐다. 근거: Changes #3
doctor --fix legacy migration 보강: 다른 config 검증 문제가 있어도 agents.defaults.llm 같은 legacy key 정리는 doctor --fix가 안전하게 커밋하도록 바뀌었다. 근거: Changes #4
차단된 optional tool setup 생략: effective tool denylist로 이미 막힌 optional media/PDF tool factory는 hot path에서 불필요하게 준비하지 않도록 개선됐다. 근거: Changes #5
잘못된 config 자동 복구 중단: Gateway startup과 hot reload가 invalid config를 자동 복원하지 않고 fail-closed로 멈추며, 복구는 openclaw doctor --fix가 맡도록 정리됐다. 근거: Changes #7
운영 관점에서 볼 점
공식 플러그인 설치 경로 강화: 공식 플러그인의 설치, 제거, 업데이트, 온보딩, ClawHub fallback, npm dependency-state 보고, beta-channel 업데이트 경로가 더 안전하게 다듬어졌다. 근거: Highlights #2
설치·업데이트 복구 경로 강화: macOS LaunchAgent 업그레이드 복구, source-only 플러그인 패키지의 runtime load 전 거부, 업데이트와 doctor 실행 중 stale Gateway/plugin 상태 복구가 추가됐다. 근거: Highlights #5
에이전트 런타임 안정성 개선: 스트리밍 provider 응답, 지연된 A2A 세션 응답, prompt/tool 전달, memory recall, web search provider discovery, provider별 thinking/model metadata가 흔한 edge case에서도 보존되도록 개선됐다. 근거: Highlights #6
보안과 버그 수정
이번 릴리즈의 수정사항은 아래 항목들을 중심으로 보면 된다.
WhatsApp 의존성 설치 문제 수정: pnpm v9+ 환경에서 baileys git-tarball 하위 의존성이 거부되어 inbound agent replies가 막히던 문제를 줄이기 위해 libsignal-node 허용 설정이 보강됐다. 근거: Fixes #1
Gateway env 파일 secret 보존: Gateway re-stage 중 OpenClaw 관리 key는 갱신하되 운영자가 추가한 env secret은 보존하도록 systemd env 파일 처리가 수정됐다. 근거: Fixes #2
Mattermost progress draft 표시 수정: channels.mattermost.streaming.progress.toolProgress=false 설정을 존중해 최종 전달 전 compact tool status line이 보이지 않도록 수정됐다. 근거: Fixes #28
채널 streaming progress 설정 노출: streaming.progress.label, labels, maxLines, toolProgress 설정이 bundled channel config metadata에 노출되어 config, docs, control surface에서 확인 가능해졌다. 근거: Fixes #32
업그레이드
npm install -g openclaw@latest
openclaw --version자동화, 채널, 플러그인, Gateway 운영 경로처럼 실제 운영에 닿는 항목이 포함된 릴리즈라면 업데이트 뒤 채널 연결과 크론 동작을 한 번 확인하는 편이 안전하다.
요약
| 영역 | 핵심 포인트 |
|---|---|
| 플러그인 | file-transfer 플러그인 추가 - paired node에서 바이너리 파일을 다루는 file-transfer 플러그인이 번들로 추가됐다. file_fetch, dir_list, dir_fetch, file_write 도구와 노드별 default-deny 경로 정책, symlink traversal 차단, 16MB 전송 한도가 함께 들어갔다. |
| 운영 | Gateway lazy-loading 성능 개선 - 플러그인·런타임 discovery, cron, schema, shutdown hook, session, model metadata 같은 Gateway 경로가 필요할 때 로드되도록 바뀌어 시작과 운영 부담이 줄었다. |
| 채널 | 채널 reply·delivery 복구 강화 - Discord 상태 반응과 degraded transport 보고가 개선됐고, WhatsApp Channel/Newsletter 대상이 추가됐으며 Telegram, Feishu, Matrix, Microsoft Teams, Slack의 delivery/recovery 동작이 더 단단해졌다. |
릴리즈 노트
https://github.com/openclaw/openclaw/releases/tag/v2026.5.3
Release OpenClaw 2026.5.3 · openclaw/openclaw
Highlights Plugins/file-transfer: add bundled file-transfer plugin with file_fetch, dir_list, dir_fetch, and file_write agent tools for binary file ops on paired nodes; default-deny per-node path ...
github.com
