오늘 오픈클로 GitHub에 새 버전이 올라왔습니다. 태그는 v2026.3.28.
릴리즈 노트를 처음 펼쳤을 때 분량에 잠깐 멈췄습니다. Breaking 2개, Changes 16개, Fixes 70개 이상. 작은 업데이트가 아닙니다. 하나도 하나도 빠짐없이 쉽게 풀어드립니다.
새 버전을 잘 이해하면 내 AI 비서가 더 잘 일하게 만들 수 있습니다.
먼저 전체 그림부터
이번 업데이트를 한 문장으로 요약하면 이렇습니다.
"AI 비서가 더 많은 곳에서 더 많은 일을 할 수 있게 됐고, 하다가 실수할 뻔한 것들도 많이 고쳤다."
크게 세 덩어리입니다.
v2026.3.28 업데이트
반드시 확인
Breaking Changes
- Qwen 로그인 방식 변경
OAuth → ModelStudio API 키 - 구형 설정 자동수정 폐지
2개월+ 오래된 설정은 수동 정리 필요
총 2가지
새로 생긴 것
Changes
- Grok 실시간 웹 검색 (x_search)
- MiniMax 이미지 생성
- 도구 실행 전 승인 요청 훅
- 현재 채널을 AI 작업공간으로
- Gemini CLI 백엔드 추가
- Slack · Teams · Google Chat 파일 업로드
- Matrix TTS 음성 버블
- openclaw config schema 명령어
총 16가지
고쳐진 것
Fixes
- Discord 재연결 무한루프
- WhatsApp 셀프챗 에코 루프
- Telegram 단어 중간 잘림
- 429 레이트리밋이 전 모델 차단
- Gemini 3.1 모델 인식 오류
- Claude Sonnet 4.6 컨텍스트 표시
- 메모리 검색 unknown provider
- GitHub Copilot 토큰 무한루프
총 70가지 이상
🔴 Part 1. 반드시 확인해야 할 변경 (Breaking Changes)
Breaking Change는 "이것 모르면 갑자기 안 될 수도 있어요" 하는 것들입니다. 딱 두 개입니다.
1-1. Qwen 로그인 방식이 바뀌었습니다
이전: portal.qwen.ai에서 OAuth로 자동 로그인
지금: ModelStudio에서 API 키를 직접 발급받아야 함
쉽게 말하면, 예전엔 "소셜 로그인(카카오로 시작하기)"이었는데 이제는 "이메일+비밀번호"로만 가능하다는 뜻입니다.
내가 해야 할 것:
# 터미널에서 이 명령어를 실행합니다
openclaw onboard --auth-choice modelstudio-api-key
Qwen을 안 쓰면 해당 없습니다. Qwen이 뭔지 모르겠다면 건너뛰셔도 됩니다.
1-2. 오래된 설정 파일 자동수정 기능이 없어집니다
이전: 2개월 이상 된 구식 설정도 오픈클로가 자동으로 고쳐줌 지금: 2개월 이상 된 구식 설정은 자동수정 안 함 → 오류 발생
마치 "버전 오래된 앱은 더 이상 자동 업데이트 안 해줌" 같은 겁니다.
오픈클로를 오래 전부터 쓰고 있고, 설정을 한 번도 정리하지 않은 분이라면:
openclaw doctor
위 명령어로 설정 파일 상태를 점검하세요. 문제가 있다면 알려줍니다.
✨ Part 2. 새로 생긴 것들 (Changes)
2-1. Grok이 인터넷 검색을 할 수 있게 됐어요 (x_search)
xAI의 Grok 모델이 이제 실시간 웹 검색을 할 수 있습니다. 이름은 x_search.
사용자: "오늘 비트코인 가격이 얼마야?"
이전 Grok 지금 Grok (x_search)
┌───────────┐ ┌───────────────────────┐
│ 학습 데이터 │ │ 학습 데이터 │
│ 기준으로만 │ ─→ │ + │
│ 답변 │ │ 🌐 실시간 인터넷 검색 │
└───────────┘ └───────────────────────┘
"2024년 기준으로..." "현재 시세는 XXX달러입니다."
추가로 바뀐 것:
- Grok이 Responses API로 업그레이드됨 (내부적으로 더 안정적인 방식)
openclaw onboard또는openclaw configure --section web실행 중에 x_search 설정 화면이 나옴- 이전에 Grok 웹 검색을 설정해 뒀다면 플러그인 토글 없이도 자동 활성화됨
2-2. MiniMax로 이미지를 만들 수 있게 됐어요
MiniMax의 image-01 모델이 오픈클로에 연결됐습니다. 두 가지 방식을 지원합니다.
┌──────────────────────────────────────────────────────────┐
│ MiniMax image-01 — 두 가지 모드 │
├────────────────────────────┬─────────────────────────────┤
│ 텍스트 → 이미지 생성 │ 이미지 → 이미지 편집 │
│ (Text-to-Image Generate) │ (Image-to-Image Editing) │
│ │ │
│ "바다 위 석양을 배경으로 │ [기존 사진] + │
│ 앉아있는 고양이 한 마리" │ "배경을 우주로 바꿔줘" │
│ ↓ │ ↓ │
│ [이미지 생성됨] │ [편집된 이미지] │
│ │ │
│ + 가로/세로 비율 선택 가능 │ + 가로/세로 비율 선택 가능 │
└────────────────────────────┴─────────────────────────────┘
M2.7 모델 하나로 정리됐습니다. 이전에 있던 M2, M2.1, M2.5, VL-01은 제거됐습니다.
2-3. 도구 실행 전에 "정말요?" 확인 기능이 생겼어요 (requireApproval)
이게 이번 업데이트에서 가장 실용적인 기능입니다.
AI 에이전트가 뭔가 중요한 행동을 하기 전에 먼저 사람에게 허락을 받을 수 있게 됐습니다.
[승인 요청 흐름]
사용자: "파일 삭제해줘"
↓
에이전트가 도구 실행 준비
↓
┌──────────────────────────────────┐
│ requireApproval 훅 발동 │
│ │
│ "정말로 파일을 삭제할까요? │
│ [✅ 승인] [❌ 취소]" │
└──────────────────────────────────┘
↓ ↓
사용자가 승인 사용자가 취소
↓ ↓
도구 실행됨 도구 실행 안됨
어디서 승인 버튼을 누를 수 있냐면:
- 컨트롤 UI (웹 화면)에서 팝업으로 뜸
- Telegram 채팅에서 버튼으로 뜸
- Discord 채팅에서 버튼으로 뜸
- 텍스트 채널에서는
/approve명령어로 승인 가능
/approve 명령어는 이제 파일 실행 승인과 플러그인 승인 두 가지를 모두 처리합니다.
2-4. 지금 쓰는 채팅방을 AI 작업공간으로 바꿀 수 있어요 (ACP current-conversation bind)
이전에는 AI 에이전트를 소환하면 새로운 채널/스레드가 생성됐습니다.
이제는 지금 대화하고 있는 방 자체를 AI 작업공간으로 전환할 수 있습니다.
이전 방식 새로운 방식
┌─────────────────────────┐ ┌─────────────────────────────────┐
│ #현재-채팅-방 │ │ #현재-채팅-방 │
│ │ │ │
│ 나: "/acp spawn codex" │ │ 나: "/acp spawn codex │
│ 봇: "새 채널 만들었어요" │ │ --bind here" │
│ │ │ 봇: "이 채널이 작업공간이 됐어요" │
│ → #codex-workspace-1 │ │ │
│ (새 채널 생성됨) │ │ → 채널 이동 없이 바로 작업 시작 │
└─────────────────────────┘ └─────────────────────────────────┘
Discord, BlueBubbles, iMessage에서 지원됩니다.
2-5. OpenAI에서 apply_patch가 기본으로 켜졌어요
apply_patch는 AI가 파일을 수정할 때 사용하는 도구입니다. 코드 편집, 문서 수정 등에 사용됩니다.
이전엔 직접 켜줘야 했는데, 이제는 OpenAI와 OpenAI Codex 모델에서 자동으로 활성화됩니다.
2-6. Gemini CLI 백엔드가 추가됐어요
오픈클로는 AI 모델을 직접 호출하는 방식 외에, AI CLI 도구를 백엔드로 연결해서 쓸 수도 있습니다.
기존에는 Claude CLI, Codex CLI만 있었는데, Gemini CLI가 추가됐습니다.
┌────────────────────────────────────────────────────────┐
│ 오픈클로 CLI 백엔드 비교표 │
├──────────────────┬──────────────────┬──────────────────┤
│ Claude CLI │ Codex CLI │ Gemini CLI │
│ (기존) │ (기존) │ (신규 추가) │
├──────────────────┼──────────────────┼──────────────────┤
│ Anthropic의 │ OpenAI의 │ Google의 │
│ Claude 모델 │ Codex 모델 │ Gemini 모델 │
├──────────────────┼──────────────────┼──────────────────┤
│ stream-json 방식 │ stream-json 방식 │ stream-json 방식 │
│ 으로 업그레이드 │ │ │
│ (진행상황 표시) │ │ │
└──────────────────┴──────────────────┴──────────────────┘
또한 Claude CLI, Codex CLI, Gemini CLI 모두 이제 설정에서 명시적으로 등록하지 않아도 자동으로 로드됩니다. (예전엔 plugins.allow에 직접 추가해야 했음)
2-7. Podman 컨테이너 설정이 단순해졌어요
Podman은 Docker와 비슷한 컨테이너 도구입니다. 서버에서 오픈클로를 컨테이너로 실행하는 분들에게 해당합니다.
이전엔 별도의 openclaw 서비스 사용자 계정을 만들어야 했는데, 이제는 현재 로그인한 사용자 기준으로 설정이 자동으로 잡힙니다.
런치 헬퍼 설치 경로도 ~/.local/bin으로 통일됐습니다.
2-8. Slack에서 파일을 더 정교하게 올릴 수 있어요
Slack에 upload-file 전용 액션이 생겼습니다.
기존 방식: "파일 보내줘" → 아무 방식으로나 전송
새로운 방식: upload-file 액션 사용 → 아래 옵션 선택 가능
┌─────────────────────────┐
│ upload-file 옵션 │
│ • 파일 이름 지정 │
│ • 제목 지정 │
│ • 코멘트 추가 │
│ • 채널/DM 선택 │
└─────────────────────────┘
2-9. Teams와 Google Chat에서도 파일 전송이 됩니다
파일 전송 기능이 Microsoft Teams와 Google Chat으로 확장됐습니다. BlueBubbles도 upload-file 액션을 통해 파일 전송을 지원합니다.
파일 전송 지원 채널 현황
이전 지금
────────────────── ──────────────────────────────
• Slack • Slack
• (일부 채널만 가능) • Microsoft Teams ← 신규
• Google Chat ← 신규
• BlueBubbles (통합) ← 통합
2-10. Matrix에서 TTS 음성이 음성 버블로 전송됩니다
Matrix 채널에서 AI가 텍스트를 음성으로 읽어주는 TTS(Text-to-Speech) 기능을 쓰면, 이전엔 그냥 오디오 파일이 첨부됐습니다.
이제는 Matrix 앱에서 음성 버블(voice bubble)로 표시됩니다. 일반 오디오 첨부와 다르게 바로 재생 버튼이 뜨는 형태입니다.
2-11. 새 명령어: openclaw config schema
터미널에서 openclaw config schema를 실행하면 openclaw.json 설정 파일이 어떤 형식이어야 하는지 전체 스키마를 출력해줍니다.
openclaw config schema
# openclaw.json 에서 사용 가능한 모든 설정 키와 형식을 JSON Schema 형태로 출력
2-12. 나머지 변경들 (요약)
나머지 변경 사항
🔧 Part 3. 고쳐진 것들 (Fixes)
70개 이상의 버그 수정이 있었습니다. 실생활에 영향을 주는 것들을 중심으로 정리합니다.
3-1. Discord 재연결이 무한루프에 빠지던 문제
Discord 게이트웨이(연결 통로)가 끊길 때 다시 연결하는 과정에서, 이미 죽은 소켓이 계속 살아있다고 착각해서 연결을 끝없이 반복하는 문제가 있었습니다.
이제는 오래된 소켓을 정리하고 resume 상태도 초기화한 뒤 새로 연결합니다.
이전 문제 상황:
연결 끊김 → 재연결 시도 → 오래된 소켓이 방해 → 재연결 실패
→ 재연결 시도 → 오래된 소켓이 방해 → 재연결 실패 → [무한반복]
수정 후:
연결 끊김 → 오래된 소켓 강제 정리 → resume 상태 초기화 → 새 연결 성공
3-2. WhatsApp 셀프챗에서 자기 메시지가 메아리처럼 돌아오던 문제
WhatsApp에서 봇이 혼자 대화하는 모드(self-chat DM mode)를 사용할 때, 봇이 보낸 메시지를 오픈클로가 "새 메시지가 왔다"고 착각해서 다시 처리하는 문제가 있었습니다.
이제는 봇이 보낸 메시지는 인바운드로 처리하지 않습니다.
3-3. Telegram 긴 메시지가 단어 중간에서 잘리던 문제
Telegram은 메시지 길이 제한이 있어서 긴 메시지는 여러 개로 나눠 보냅니다. 이 과정에서 단어 중간에서 잘리는 일이 있었습니다. "안녕하세요"가 "안녕하" / "세요"로 나뉘는 것처럼요.
이제 단어 경계에서 나눕니다. 또한 공백만 있는 메시지를 보내면 Telegram이 오류를 냈는데, 이것도 자동으로 건너뜁니다.
3-4. API 429 에러가 모든 모델을 막던 문제
API를 너무 많이 호출하면 429 Too Many Requests 에러가 납니다. 피로 게이지가 가득 찬 것처럼요.
이전에는 하나의 모델에서 429가 나면 같은 인증 프로필의 모든 모델이 다 막혔습니다.
이전:
GPT-4에서 429 → Claude도 막힘, Gemini도 막힘, 전부 막힘
이후:
GPT-4에서 429 → GPT-4만 막힘, 다른 모델은 정상 동작
쿨다운 시간도 개선됐습니다: 1분→1시간 식의 지수 증가 방식에서 30초/1분/5분의 단계적 증가로 바뀌었습니다. 모든 모델이 막혔을 때는 남은 시간을 카운트다운으로 보여줍니다.
3-5. Gemini 3.1 모델이 인식 안 되던 문제
Google의 Gemini 3.1 Pro, Flash, Flash-Lite 모델을 설정해도 오픈클로가 찾지 못하는 문제가 있었습니다. 모델 ID 매핑 방식을 수정해서 해결됐습니다.
3-6. OpenAI Codex에서 이미지 분석이 안 되던 문제
Codex로 이미지를 분석하려 하면 "provider registration 없음" 또는 "instructions 없음" 오류가 났습니다. 이제 이미지 프롬프트가 Codex instructions를 통해 제대로 라우팅됩니다.
3-7. 메모리 검색이 특정 상황에서 실패하던 문제
메모리 플러그인이 분리된 런타임에서 실행될 때, 메모리 검색에 필요한 임베딩 프로바이더가 등록되지 않아 "unknown provider" 오류가 났습니다. 이제 런타임 간 임베딩 프로바이더를 공유합니다.
3-8. Claude Sonnet 4.6 컨텍스트 윈도우 표시 오류
/status 명령어로 상태를 확인할 때, Claude Sonnet 4.6의 컨텍스트 윈도우 크기가 실제 100만 토큰 대신 잘못된 작은 값으로 표시됐습니다. 이제 올바르게 표시됩니다.
3-9. 나머지 주요 수정들
채널별 수정 사항 요약
Discord
├── 재연결 루프 수정 (위 3-1)
├── 포럼 토픽 스레드에서 verbose 요약 다시 표시됨
├── 긴 코드 블록의 들여쓰기가 유지됨
└── Carbon 베타 라이브러리 업데이트
Telegram
├── 긴 메시지 잘림 수정 (위 3-3)
├── 공백 메시지 전송 오류 수정
├── 포럼 토픽에서 /new, /reset 명령어 정상 동작
└── reply_to 메시지 ID 검증 강화
WhatsApp
├── 셀프챗 에코 루프 수정 (위 3-2)
├── 멘션이 포함된 인용 메시지 오인식 수정
└── allowFrom 오류 메시지 명확화
Telegram·iMessage
└── [[reply_to:...]] 태그가 실제 전송 메시지에 노출되던 문제 수정
BlueBubbles
├── 디바운스 null 텍스트 오류 수정
├── 그룹 멤버 연락처 이름 표시 개선
└── CLI 에이전트 이미지 참조 복원
Matrix
├── TTS 음성 버블 전송 (위 2-10)
├── 폴 메시지 인용 시 폴 내용 컨텍스트에 포함
├── 암호화된 이미지 썸네일 처리 개선
└── 2인 방과 DM 라우팅 구분 개선
Mistral
└── 422 오류 반복 현상 수정
GitHub Copilot
└── 토큰 만료 시간 계산 오류로 인한 무한 루프 수정
Feishu
├── WebSocket 연결이 끊어도 유령 연결이 남던 문제 수정
└── 오프라인 메시지의 타임스탬프 오류 수정
기타
├── ACP/ACPX 에이전트 레지스트리 정렬 (미확인 에이전트 ID가 임의 명령어 실행되던 보안 문제 수정)
├── 웹 검색 키 감사: Gemini, Grok, Kimi, Moonshot, OpenRouter 인증정보 인식 추가
├── Brave 검색에서 VN 같은 특수 국가 코드가 오류 내던 문제 수정
└── CLI zsh 완성(completion) 플러그인 매니저와 충돌 문제 수정
무엇이 가장 먼저 써볼 만한가
이번 업데이트에서 바로 체감할 수 있는 것 세 가지를 고르면:
추천 순서 (체감 효과 기준)
1위 ─ requireApproval 훅
중요한 작업 전 사람이 한 번 더 확인하는 안전망.
실수로 파일 삭제되거나 잘못된 API 호출하는 걸 방지.
2위 ─ 모델별 개별 레이트 리밋
API 한도 초과가 오래 막히지 않음.
하나 막혀도 다른 모델로 자동 전환됨.
3위 ─ Grok x_search (Grok 사용자 한정)
Grok이 실시간 정보를 검색할 수 있어짐.
오래된 학습 데이터 한계를 보완.
마치며
v2026.3.28은 기능 확장보다 안정성과 실용성에 무게를 둔 버전입니다. 새로운 화려한 기능보다, 기존 기능이 더 믿을 수 있게 작동하는 데 집중했습니다.
특히 Discord, Telegram, WhatsApp, Matrix 등 각 채널의 엣지 케이스를 꼼꼼히 다듬었습니다. 멀티채널 환경에서 오픈클로를 쓰는 분이라면 느껴지는 안정감이 달라졌을 겁니다.
