OpenClaw 2026.3.11이 나왔다. beta.1에서 약 4시간 만에 stable로 올라온 빠른 릴리즈다. 공식 X에서 꼽은 핵심은 Hunter & Healer 무료 1M context 모델, GPT-5.4 안정화, Gemini Embedding 2 메모리 강화, 그리고 Security hardening sprint다.
실사용자 입장에서 가장 신경 써야 할 건 크론 Breaking Change다. 기존 크론잡이 있으면 openclaw doctor --fix를 실행해야 한다.
핵심 3가지
1. Hunter & Healer Alpha — OpenRouter를 통해 1M context 무료 모델 약 1주일 한정 제공
2. Gemini Embedding 2 메모리 — 이미지/오디오 포함 멀티모달 메모리 검색 지원
3. 크론 Breaking Change — isolated cron delivery 정책 강화, 마이그레이션 필요
Hunter Alpha & Healer Alpha
OpenRouter의 신규 stealth 모델 두 개가 빌트인 카탈로그에 추가됐다. 약 1주일 한정 무료 제공이다.
model: openrouter/hunter-alpha # 1M context
model: openrouter/healer-alphaHunter Alpha의 컨텍스트 윈도우가 1,050,000 토큰이다. 긴 코드베이스 분석이나 대용량 문서 처리에 써볼 수 있다. OpenRouter 계정만 있으면 무료로 사용 가능하고, 추가 설정 없이 모델명만 바꾸면 된다.
공식 X 문구가 "free stealth models"라 정확한 모델 아키텍처는 공개되지 않았다. 1주일 한정이니 빨리 테스트해보는 걸 추천한다.
Gemini Embedding 2 메모리 검색
메모리 검색에 gemini-embedding-2-preview를 쓸 수 있게 됐다. 기존 텍스트 전용 임베딩에서 이미지, 오디오까지 멀티모달 인덱싱으로 확장됐다.
memory:
search:
provider: gemini
model: gemini-embedding-2-preview
outputDimensions: 3072 # 선택, 기본값 사용 가능
extraPaths:
- ~/pictures/screenshots # 이미지 인덱싱
- ~/recordings # 오디오 인덱싱opt-in 방식이라 기존 메모리에 영향 없다. memorySearch.extraPaths에 경로를 추가해야 멀티모달 인덱싱이 시작된다. 차원 수(outputDimensions)를 변경하면 자동으로 재인덱싱된다.
Gemini API 키가 있어야 사용 가능하다. 이미지 검색이 필요한 스크린샷 관리, 오디오 노트 검색 등 활용 범위가 넓어졌다.
크론 Breaking Change (필수 확인)
이번 릴리즈에서 가장 중요한 변경이다. isolated cron 잡의 delivery 정책이 강화됐다.
변경 내용:
• 크론 잡이 더 이상 ad hoc agent send로 결과를 전달할 수 없음
• fallback main-session 요약도 차단됨
• legacy cron storage와 notify/webhook delivery 메타데이터 마이그레이션 필요
마이그레이션:
openclaw doctor --fix한 줄로 마이그레이션된다. --fix 없이 openclaw doctor만 실행하면 어떤 잡이 영향받는지 먼저 확인할 수 있다.
기존 크론잡이 있는 경우 업그레이드 직후 doctor를 꼭 실행해야 한다. 안 하면 크론 결과 deliver가 안 될 수 있다.
ACP resumeSessionId
ACP sessions_spawn에 resumeSessionId 옵션이 추가됐다.
sessions_spawn({
runtime: "acp",
resumeSessionId: "기존_세션_ID", // 이어서 작업
task: "이전 작업 계속..."
})기존에는 ACP 세션을 spawn할 때마다 새로운 빈 세션이 생성됐다. 이제 기존 ACPX/Codex 대화를 이어받아 컨텍스트를 보존한 채 작업을 계속할 수 있다. 긴 코딩 작업에서 중간에 세션이 끊기면 다시 컨텍스트를 설명하는 불편함이 줄어든다.
macOS: 채팅 모델 피커 + Thinking 레벨 영속화
macOS 채팅 UI에 모델 피커가 추가됐다. 이전에는 config 파일을 수정해야 모델을 바꿀 수 있었는데, 이제 채팅 인터페이스에서 직접 선택 가능하다.
thinking 레벨 선택이 재시작 후에도 유지된다. 세션마다 다시 설정할 필요 없다.
보안 수정 (WebSocket origin validation)
Gateway/WebSocket에서 browser origin validation이 강화됐다 (GHSA-5wcw-8jjv-m286).
취약점 내용: trusted-proxy 모드에서 proxy header가 있든 없든 모든 browser-originated 연결에 origin 검증을 하지 않아서, cross-site WebSocket 하이재킹으로 operator.admin 권한을 획득할 수 있었다.
외부에 게이트웨이를 노출하는 경우 이 업데이트가 특히 중요하다.
macOS launchd 재시작 안정화
macOS 사용자라면 이번 수정이 체감될 것이다.
Fixes #43311, #43406, #43035, #43049게이트웨이 재시작 시 LaunchAgent가 등록 해제됐다가 다시 등록되는 문제가 있었다. self-restart를 detached launchd helper를 통해 처리하도록 변경해서 LaunchAgent가 유지된 채로 재시작된다. config 변경 후 SIGUSR1 hot reload도 포함된다.
기존에 재시작 후 게이트웨이가 자동 시작 안 되는 문제가 있었다면 이번 버전에서 해결됐다.
Discord autoArchiveDuration
자동 생성 스레드의 아카이브 기간을 설정할 수 있게 됐다.
discord:
autoArchiveDuration: 1440 # 1일 (분 단위: 60, 1440, 4320, 10080)기본값이 1시간(60분)으로 너무 짧아서 스레드가 금방 아카이브되는 불편함이 있었다. 이제 1시간/1일/3일/1주일 중 선택 가능하다.
기타 수정
GLM-5/DeepSeek 제어 토큰 제거 — 모델 내부 구분자(<|im_start|> 등)가 사용자에게 노출되는 문제 수정. GPT-5.4가 "stops stopping mid-thought"라고 피터가 언급한 것도 이 계열 수정 포함.
Kimi Coding tool call 수정 — anthropic-messages tools를 올바른 포맷으로 전송해서 tool_use 블록 대신 XML 텍스트로 내려오던 문제 해결.
billing recovery — 크레딧 충전 후 gateway restart 없이 cooldown에서 자동 복구.
Telegram 전송 안정화 — 긴 HTML 메시지 청킹, 최종 preview delivery 중복 전송 수정 여러 건.
업그레이드
# npm
npm i -g openclaw@latest
# openclaw CLI
openclaw update업그레이드 후 필수:
# 먼저 doctor로 확인
openclaw doctor
# 마이그레이션 실행
openclaw doctor --fix크론잡이 없어도 한 번 실행해두면 안전하다.
요약
| 기능 | 핵심 포인트 |
|---|---|
| Hunter/Healer Alpha | OpenRouter 무료 1M context 모델, 1주일 한정 |
| Gemini Embedding 2 | 이미지/오디오 멀티모달 메모리 검색, opt-in |
| 크론 Breaking | isolated delivery 강화, doctor --fix 필수 |
| ACP resumeSessionId | 기존 ACP 세션 재개, 컨텍스트 보존 |
| macOS 모델 피커 | 채팅 UI에서 직접 모델 선택 + thinking 레벨 영속화 |
| WebSocket 보안 | cross-site 하이재킹 취약점 수정 (GHSA-5wcw-8jjv-m286) |
| launchd 재시작 | LaunchAgent 유지 재시작, hot reload 안정화 |
릴리즈 노트
https://github.com/openclaw/openclaw/releases/tag/v2026.3.11
Release openclaw 2026.3.11 · openclaw/openclaw
Security Gateway/WebSocket: enforce browser origin validation for all browser-originated connections regardless of whether proxy headers are present, closing a cross-site WebSocket hijacking path ...
github.com
