OpenClaw v2026.3.24가 릴리즈됐다. 이번 버전은 Microsoft Teams 공식 SDK 전환, Gateway/OpenAI 호환 API 확장, Control UI 전면 개편이 핵심이다. 보안 패치와 플랫폼 안정성 수정도 포함됐다.
핵심 3가지
Microsoft Teams 공식 SDK 전환: 스트리밍 답변, 웰컴 카드, 피드백 반영, AI 라벨링 등 Teams 전용 UX가 대폭 강화됐다. 메시지 편집/삭제 지원도 추가됐다.
Gateway OpenAI 호환성 확장: /v1/models, /v1/embeddings 엔드포인트가 추가돼 OpenAI 클라이언트 및 RAG 파이프라인과 직접 연동이 가능해졌다.
Control UI 전면 개편: Skills 상태 탭 필터(All/Ready/Needs Setup/Disabled), 에이전트 파일 펼치기 미리보기, macOS 앱 트리 사이드바가 추가됐다.
변경사항
Gateway / OpenAI 호환성
/v1/models, /v1/embeddings 엔드포인트가 새로 생겼다. /v1/chat/completions와 /v1/responses에서 명시적 모델 오버라이드도 포워드된다. OpenAI 클라이언트나 RAG 시스템을 OpenClaw Gateway에 직접 연결할 때 유용하다.
Agents / Tools
/tools 엔드포인트가 현재 에이전트가 실제로 쓸 수 있는 도구만 표시하도록 바뀌었다. 기본 컴팩트 뷰와 상세 모드가 분리됐고, Control UI에 "Available Right Now" 섹션이 추가돼 질문 전에 도구 상태를 확인할 수 있다.
Microsoft Teams
공식 Teams SDK로 마이그레이션됐다. 스트리밍 1:1 답변, 프롬프트 스타터 포함 웰컴 카드, 피드백/반영, 상태 업데이트, 타이핑 인디케이터, AI 라벨링이 추가됐다. 메시지 편집/삭제도 지원한다.
Skills / 설치 메타데이터
번들 스킬(coding-agent, gh-issues, openai-whisper-api, session-logs, tmux, trello, weather)에 원클릭 설치 레시피가 추가됐다. CLI와 Control UI에서 의존성 설치를 바로 실행할 수 있다.
Control UI
Skills 페이지에 상태 필터 탭(All/Ready/Needs Setup/Disabled)이 생겼다. 카드 클릭 시 상세 다이얼로그로 전환되며 API 키 입력, 토글, 설치 액션, 홈페이지 링크가 포함된다. 에이전트 파일 행은 인라인 마크다운 미리보기를 지원하는 확장 가능한 <details>로 바뀌었다.
Slack / Interactive 답변
다이렉트 딜리버리에서 리치 답변 패리티가 복원됐다. 간단한 "Options:" 라인을 자동으로 버튼/셀렉트로 렌더링하고, Slack 인터랙티브 설정 기본값도 개선됐다.
CLI / 컨테이너 지원
--container와 OPENCLAW_CONTAINER 환경 변수가 추가됐다. 실행 중인 Docker/Podman 컨테이너 내부에서 openclaw 명령을 직접 실행할 수 있다.
Discord / Auto Thread 이름 생성
autoThreadName: "generated" 옵션이 추가됐다. 새 자동 스레드에 LLM이 비동기로 간결한 제목을 붙인다. 기존 메시지 기반 명명 방식은 기본값으로 유지된다.
Runtime / Node.js 지원
Node 22 최소 버전이 22.14+로 낮아졌다. Node 24 권장은 유지된다. openclaw update가 업그레이드 전에 engines.node를 사전 검사해 지원 안 되는 버전에서 명확한 오류 메시지를 표시한다.
macOS 앱 / 설정 UI
수평 pill 기반 서브섹션 내비게이션이 접을 수 있는 트리 사이드바로 교체됐다. API 키 에디터 다이얼로그에 "키 발급" 홈페이지 링크와 저장 경로 힌트가 추가됐다.
보안 패치
미디어 접근 정책 정렬
아웃바운드 미디어 접근이 설정된 fs 정책과 맞게 정렬됐다. workspaceOnly가 꺼진 경우 호스트 로컬 파일과 인바운드 미디어 경로가 계속 전송된다. 워크스페이스 전용 에이전트는 샌드박스가 유지된다.
샌드박스 미디어 우회 차단
mediaUrl/fileUrl 별칭 우회가 차단됐다. 아웃바운드 도구와 메시지 액션이 미디어 루트 제한을 벗어날 수 없게 됐다.
버그 수정
Gateway 재시작 후 세션 복구
재시작 후 중단된 에이전트 세션을 하트비트로 깨우도록 수정됐다. 아웃바운드 딜리버리 일시 실패 시 1회 재시도, Telegram 토픽이나 Slack 스레드로의 라우팅도 보존된다.
Docker 초기 설치 루프
사전 시작 시 openclaw-cli 공유 네트워크 네임스페이스 루프 문제가 수정됐다. 설정 시간 작업이 openclaw-gateway를 통해 라우팅되므로 게이트웨이가 올라오기 전 Docker 신규 설치가 실패하는 문제가 해결됐다.
채널 순차 시작
채널 시작을 순차적으로 유지하면서 채널별 실패를 격리했다. 하나의 채널 오류가 다른 채널 시작을 막지 않는다.
Embedded Run / SecretRef 크래시
미해결 SecretRef 설정이 임베디드 에이전트 실행을 중단시키는 문제가 수정됐다. 런타임 스냅샷으로 폴백한다.
WhatsApp 그룹 에코 억제
게이트웨이가 최근 보낸 메시지 ID를 추적해 일치하는 그룹 에코만 억제한다. 연결 계정의 fromMe 트래픽에서 오는 /status, /new, /activation 명령은 보존된다.
Telegram 포럼 토픽 / Discord 타임아웃 / ACP 직접 채팅
Telegram이 포럼 메타데이터를 생략할 때 #General 토픽 라우팅이 복구됐다. Discord 인바운드 워커 타임아웃 시 가시적인 타임아웃 답변이 전송된다. ACP 마지막 TTS가 오디오를 생성하지 않을 때도 터미널 결과가 항상 딜리버리된다.
Telegram 아웃바운드 에러 / 사진 업로드
403 멤버십/차단 세부 정보가 보존되고 bot not a member는 영구 실패로 처리된다. 사진 크기/비율 규칙을 사전 검사해 메타데이터가 유효하지 않으면 문서 전송으로 폴백한다.
업그레이드
npm update -g openclaw
요약
| 분야 | 핵심 포인트 |
|---|---|
| Teams SDK 전환 | 공식 SDK 마이그레이션, 스트리밍/AI 라벨링/편집 지원 |
| OpenAI 호환 API | /v1/models, /v1/embeddings 추가로 RAG 연동 확대 |
| Control UI 개편 | Skills 상태 필터, 파일 인라인 미리보기, 트리 사이드바 |
| 보안 | 미디어 샌드박스 우회 차단, fs 정책 정렬 |
| 안정성 | Docker 루프, 채널 순차 시작, SecretRef 크래시 수정 |
| Node 지원 | 최소 Node 22.14+, 업그레이드 전 engines 사전 검사 |
릴리즈 노트
https://github.com/openclaw/openclaw/releases/tag/v2026.3.24
Release openclaw 2026.3.24 · openclaw/openclaw
Breaking Changes Gateway/OpenAI compatibility: add /v1/models and /v1/embeddings, and forward explicit model overrides through /v1/chat/completions and /v1/responses for broader client and RAG com...
github.com
