OpenClaw 2026.4.8 릴리즈 노트 분석 - 패키징 안정화, 에이전트 도구 정리, 프록시·슬랙 수정

OpenClaw 2026.4.8 릴리즈는 새 기능 추가보다 설치본 안정화와 운영 환경 버그 수정에 집중했다. 특히 npm 설치본에서 번들 채널과 setup contract 로딩이 깨지던 문제를 정리했고, 에이전트 도구 응답과 /exec 기본값 표기를 실제 런타임 동작에 맞췄다. 프록시 환경과 Slack 연동에서 걸리던 자잘한 운영 이슈도 같이 닫았다.

핵심 3가지

패키징 안정화: Telegram과 여러 번들 채널이 설치형 npm 빌드에서도 누락된 dist/src 경로를 찾지 않도록 sidecar 로딩으로 정리했다.
에이전트 도구 정리: OpenAI 계열 런에서 update_plan을 계속 쓸 수 있게 유지하면서 응답 payload는 더 짧게 정리했고, /exec 기본 정책 표시도 실제 환경별 fallback과 맞췄다.
프록시·Slack 수정: Slack Socket Mode가 HTTP(S) 프록시와 NO_PROXY를 제대로 따르도록 고쳤고, SecretRef 기반 토큰 재로딩 문제와 env-proxy DNS pinning 충돌도 함께 수정했다.

 

변경사항

설치형 npm 빌드에서 채널 로딩 실패를 막았다

이번 릴리즈의 가장 큰 포인트는 packaged build 안정화다. Telegram setup과 BlueBubbles, Feishu, Google Chat, IRC, Matrix, Mattermost, Microsoft Teams, Nextcloud Talk, Slack, Zalo 같은 번들 채널이 더 이상 설치 후에 dist/extensions/*/src/* 같은 내부 개발 경로를 찾지 않는다. 배포 패키지에서 top-level sidecar contract를 읽도록 바꿔서 gateway startup 단계에서 바로 죽던 문제를 막았다.

번들 플러그인 호환성 메타데이터를 릴리즈 버전에 맞췄다

채널이 로드돼도 compatibility metadata가 어긋나면 provider나 plugin이 비활성화될 수 있다. 2026.4.8에서는 번들 플러그인 메타데이터도 릴리즈 버전에 맞춰 정렬해서 설치 직후 로드 실패 가능성을 줄였다. npm 전역 설치나 자동 업데이트를 쓰는 운영 환경에서 체감이 큰 수정이다.

 

에이전트 도구 동작 정리

update_plan을 유지하면서 응답은 더 짧게 만들었다

OpenAI 계열 런에서 update_plan 도구를 계속 사용할 수 있게 유지했다. 동시에 성공 응답 payload는 compact 형태로 정리했고, 필요 없으면 tools.experimental.planTool=false로 끌 수 있게 했다. 에이전트 진행 상황을 UI에 보여주되 응답 노이즈는 줄이려는 정리로 보면 된다.

tools:
  experimental:
    planTool: false

/exec 현재 기본값 표시를 실제 런타임과 맞췄다

이전에는 host=auto 세션에서 /exec가 더 엄격한 오래된 기본 정책을 보여줄 수 있었다. 이제 gateway나 node에서는 full/off, sandbox에서는 deny/off처럼 실제 host-aware fallback 정책에 맞는 상태가 노출된다. 운영자가 세션 상태를 읽을 때 혼동이 줄어든다.

 

프록시와 Slack 운영 이슈 수정

Slack Socket Mode가 프록시 환경을 제대로 따른다

프록시 전용 배포 환경에서는 WebSocket 연결이 생각보다 자주 발목을 잡는다. 이번 릴리즈는 Slack Socket Mode가 HTTP(S) proxy와 NO_PROXY 예외를 그대로 따라가도록 고쳤다. 별도 monkey patch 없이도 프록시 네트워크에서 바로 붙을 수 있게 한 수정이다.

SecretRef 토큰 재로딩과 env-proxy DNS pinning 충돌도 정리했다

Slack actions에서는 이미 resolve된 read token을 downloadFile에 넘기도록 바꿔서 raw config 재로딩 뒤에도 SecretRef 기반 bot token이 깨지지 않게 했다. 또 trusted env-proxy mode가 켜진 경우에는 target DNS pinning을 건너뛰도록 조정해서 trusted proxy가 outbound host를 대신 resolve하는 샌드박스도 정상 동작한다.

 

업그레이드

npm i -g openclaw@latest

openclaw update

업그레이드 후에는 설치형 빌드에서 채널 로딩이 정상인지, Slack 프록시 환경이라면 연결이 바로 살아나는지 한 번 확인하는 편이 좋다.

 

요약

항목	핵심 포인트
Telegram/setup	설치형 npm 빌드에서 누락된 dist/src import 의존을 제거했다.
Bundled channels/plugins	sidecar contract와 호환성 메타데이터 정렬로 startup 실패를 줄였다.
Agents/update_plan	도구는 유지하고 응답은 compact하게 정리했다.
Agents/exec	/exec 기본 정책 표시를 실제 환경별 fallback과 맞췄다.
Slack·Proxy	프록시 연결, SecretRef 토큰 재로딩, env-proxy DNS pinning 충돌을 수정했다.

 

릴리즈 노트

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

---

📎 릴리즈 원문

Release openclaw 2026.4.8 · openclaw/openclaw