OpenClaw 2026.3.28이 릴리즈됐다. xAI를 Responses API로 전환하면서 x_search가 기본 지원되고, 플러그인이 tool 실행 전 사용자 승인을 요청할 수 있게 됐다. MiniMax 이미지 생성도 새로 추가됐다. Breaking change 두 개, 변경사항 열다섯 개, 수정 80여 개가 들어갔다.
핵심 3가지
xAI Responses API 전환: 번들 xAI 프로바이더가 Responses API로 이동됐다. x_search가 기본 활성화되고, onboarding에서 선택적 x_search 설정을 지원한다. 기존 Grok 설정이 있으면 수동 플러그인 토글 없이도 동작한다.
requireApproval 플러그인 훅: before_tool_call 훅에서 tool 실행을 일시 중단하고 사용자 승인을 요청하는 async requireApproval이 추가됐다. exec approval overlay, Telegram 버튼, Discord 인터랙션, /approve 명령 모두 지원한다.
MiniMax 이미지 생성: image-01 모델로 텍스트-이미지, 이미지-이미지 편집이 가능해졌다. aspect ratio 제어 포함이다.
Breaking Changes
Qwen portal OAuth 제거
qwen-portal-auth OAuth 연동이 삭제됐다. portal.qwen.ai를 사용하던 경우 Model Studio로 마이그레이션해야 한다.
openclaw onboard --auth-choice modelstudio-api-keyConfig 자동 마이그레이션 범위 축소
두 달 이상 지난 레거시 config key는 더 이상 자동 재작성되지 않는다. 대신 openclaw doctor에서 검증 실패로 처리된다. 구형 설정 파일을 그대로 쓰고 있다면 doctor를 먼저 돌려볼 것.
주요 변경사항
xAI / Grok
번들 xAI 프로바이더가 Responses API로 이동됐다. x_search 툴이 추가되고 xAI 플러그인이 owned web-search / tool config에서 자동 활성화된다. onboarding과 configure --section web에서 x_search 선택적 설정을 지원하며 xAI 키 하나로 Grok 웹검색이 가능하다.
requireApproval 훅
플러그인 before_tool_call에서 async requireApproval을 쓸 수 있다. tool 실행을 멈추고 사용자 확인을 받을 수 있다. /approve 명령이 exec approval과 플러그인 approval을 모두 처리하도록 확장됐다.
MiniMax 이미지 생성
image-01 모델로 텍스트-이미지 생성과 이미지-이미지 편집이 가능하다. aspect ratio 제어를 지원한다.
ACP 채널 바인딩
Discord, BlueBubbles, iMessage에서 현재 대화를 Codex 백엔드 워크스페이스로 전환하는 current-conversation ACP bind가 추가됐다. /acp spawn codex --bind here 형태로 사용한다. 자식 스레드를 별도로 만들지 않아도 된다.
OpenAI apply_patch 기본 활성화
OpenAI 및 OpenAI Codex 모델에서 apply_patch가 기본 활성화됐다. 샌드박스 정책이 write 권한과 맞춰졌다.
번들 CLI 백엔드 플러그인화
Claude CLI, Codex CLI, Gemini CLI 번들 백엔드가 플러그인 레이어로 이동됐다. Gemini CLI 번들 지원이 추가됐고 gateway run --claude-cli-logs는 --cli-backend-logs로 대체됐다(구 플래그 호환 유지). plugins.allow에 수동 항목 없이도 자동 로드된다.
Slack upload-file 액션
Slack에 명시적 upload-file 액션이 추가됐다. filename/title/comment 오버라이드를 지원한다. Microsoft Teams, Google Chat에도 upload-file 지원이 확대됐다.
기타
openclaw config schema 명령으로 openclaw.json JSON 스키마를 출력할 수 있다. Matrix TTS가 voice bubble로 전송된다. MiniMax 모델이 M2.7로 정리됐다(M2, M2.1, M2.5, VL-01 제거). Podman 설정이 단순화됐다.
버그 수정 (주요)
Anthropic
sensitive 같은 처리되지 않은 provider stop reason을 크래시 대신 구조적 오류로 복구한다.
Google / Gemini
Gemini 3.1 pro/flash/flash-lite 모델 해석 오류가 수정됐다. empty required: [] 배열이 Google 툴 스키마에서 제거된다.
OpenAI Codex
이미지 분석 실패, 툴 call id 중복, Responses WebSocket reasoning 블록 손실 등이 수정됐다. context overflow 안내가 복구됐다.
Telegram
긴 메시지 분할이 HTML 길이 기준으로 변경됐다(비례 추정 방식 대체). 공백 응답 400 오류, replyToMessageId 검증, forum topic 라우팅이 수정됐다.
Discord
게이트웨이 stale socket 무한 루프, 강제 reconnect 후 poisoned resume state, Carbon beta 호환성, 코드 블록 들여쓰기 보존이 수정됐다.
self-chat DM 무한 echo loop, quoted message @mention 오탐이 수정됐다.
iMessage / BlueBubbles
[[reply_to:...]] 태그 누출, 이미지 ref 손실, group 참여자 이름 표시, debounce null 처리 등이 수정됐다.
Matrix
DM 라우팅, 멘션 인식, E2EE 썸네일 암호화, 플러그인 크래시 방어, env SecretRef 해석이 수정됐다.
Agent / Session
rate limit 쿨다운이 모델별로 분리됐다(기존: 프로바이더 단위). 1분→1시간 지수 증가 대신 30초/1분/5분 단계식으로 변경됐다. 모델 전환 시 active embedded run에 반영되고, 하트비트 타이머가 실패 후에도 재설정된다.
보안 / 기타
JSON-wrapped NO_REPLY 컨트롤 envelope가 채널 전송 전에 제거된다. GitHub Copilot auth refresh 타이머 overflow가 수정됐다. Feishu WebSocket ghost connection, Mattermost SecretRef 봇 토큰, Brave country 필터 422 오류 등도 수정됐다.
업그레이드
npm install -g openclaw@latest
# 또는
brew upgrade openclawQwen portal OAuth 사용자는 업그레이드 전 Model Studio 마이그레이션 필수. 오래된 config key를 사용 중이라면 openclaw doctor로 확인할 것.
요약
| 구분 | 내용 |
|---|---|
| Breaking | Qwen portal OAuth 제거, Config 자동 마이그레이션 축소 |
| 신기능 | xAI Responses API + x_search, requireApproval 훅, MiniMax 이미지 생성, ACP 채널 바인딩 |
| 개선 | 번들 CLI 플러그인화, apply_patch 기본 활성화, Slack/Teams upload-file, config schema 명령 |
| 버그 수정 | 80여 개 — Discord/Telegram/Matrix/WhatsApp/iMessage/Agent/보안 전반 |
릴리즈 노트
https://github.com/openclaw/openclaw/releases/tag/v2026.3.28
📎 릴리즈 원문
Release v2026.3.28 · openclaw/openclaw
xAI Responses API, requireApproval hooks, MiniMax image generation
github.com
