🦞 OpenClaw 2026년 3월 주요 업데이트
AI 에이전트 게이트웨이 OpenClaw의 최신 릴리스가 공개되었습니다. 이번 업데이트에는 PDF 분석 도구 신규 추가, 플러그인 SDK 대폭 확장, 텔레그램 스트리밍 기본 활성화 등 실질적인 변화가 많습니다. 하나씩 살펴보겠습니다.
📄 PDF 분석 도구 정식 추가
이번 릴리스에서 가장 눈에 띄는 기능은 first-class PDF 도구입니다.
- Anthropic, Google 모델에서 네이티브 PDF 분석 지원
- 네이티브 미지원 모델에서는 자동으로 텍스트/이미지 추출 fallback 작동
agents.defaults.pdfModel,pdfMaxBytesMb,pdfMaxPages등 설정 가능- 단일 PDF는
pdf파라미터, 다중 PDF는pdfs파라미터로 최대 10개까지 분석
바이브 코딩 환경에서 문서 기반 작업이 훨씬 수월해졌습니다. 계약서 검토, 논문 요약, 매뉴얼 분석 등을 채팅 한 번으로 처리할 수 있습니다.
🔌 플러그인 SDK 및 채널 확장성 강화
플러그인 개발자에게 반가운 소식이 많습니다.
| 변경 사항 | 설명 |
|---|---|
channelRuntime 노출 |
외부 채널 플러그인이 reply/routing/session 등 런타임 헬퍼에 직접 접근 가능 |
runtime.stt.transcribeAudioFile |
플러그인에서 로컬 오디오 파일을 OpenClaw의 STT 파이프라인으로 변환 |
runtime.events 구독 |
onAgentEvent, onSessionTranscriptUpdate 이벤트 리스너 등록 가능 |
requestHeartbeatNow |
플러그인이 특정 세션을 즉시 깨울 수 있는 API 추가 |
| 세션 라이프사이클 훅 | session_start/session_end에 sessionKey 포함 |
특히 BREAKING 변경으로 api.registerHttpHandler가 제거되고 api.registerHttpRoute로 전환되었습니다. 기존 플러그인 업데이트 시 주의가 필요합니다.
💬 텔레그램 스트리밍 기본 활성화
텔레그램 채널의 스트리밍 기본값이 off에서 partial로 변경되었습니다.
- 새로 설정하는 텔레그램 봇은 별도 설정 없이 라이브 프리뷰 스트리밍 사용 가능
- DM에서는
sendMessageDraft방식으로 미리보기 표시 - 추론(reasoning) 모드에서 추론/답변 프리뷰가 분리되어 표시
사용자 입장에서 응답을 기다리는 체감 시간이 크게 줄어듭니다.
🔐 SecretRef 전면 확대 및 보안 강화
비밀 관리 체계도 대폭 개선되었습니다.
- 64개 대상에 걸쳐 SecretRef 지원 확대
- 런타임 수집기,
openclaw secrets플로우, 온보딩 UX 전체 적용 - 미해결 참조는 활성 서피스에서 즉시 실패(fail-fast), 비활성 서피스에서는 비차단 진단 보고
🛠️ 기타 주요 변경사항
- MiniMax-M2.5-highspeed 모델 공식 지원 추가
- 서브에이전트 파일 첨부:
sessions_spawn에서 base64/utf8 인라인 파일 첨부 지원 - CLI 설정 검증:
openclaw config validate명령어로 게이트웨이 시작 전 설정 파일 검증 가능 - Ollama 임베딩: 메모리 검색에서 Ollama 임베딩 프로바이더 지원
- 멀티미디어 어댑터: Discord, Slack, WhatsApp, Zalo 전체에 공유
sendPayload지원 - 온보딩 기본 프로필 변경 (BREAKING): 새 로컬 설치 시
tools.profile이messaging으로 기본 설정 - ACP 디스패치 기본 활성화 (BREAKING): 명시적으로 비활성화하지 않으면 ACP 라우팅이 자동 활성
💡 실전 팁: OpenClaw로 바이브 코딩 시작하기
OpenClaw를 처음 접하시는 분들을 위한 빠른 시작 가이드입니다.
# 설치
npm install -g openclaw@latest
# 온보딩 (서비스 자동 설치)
openclaw onboard --install-daemon
# 채널 로그인 후 게이트웨이 실행
openclaw channels login
openclaw gateway --port 18789설치 후 http://127.0.0.1:18789/에서 웹 대시보드를 열 수 있으며, WhatsApp·Telegram·Discord를 하나의 게이트웨이로 동시에 연결할 수 있습니다.
ClawHub(clawhub.com)에서 커뮤니티가 만든 스킬을 검색·설치하면 에이전트의 능력을 빠르게 확장할 수 있습니다.
📢 안내
이신우 (이사) / 퓨처랩 https://lab.duonedu.net
📚 강의 분야: 바이브 코딩(Vibe Coding), 생성형 AI 업무 생산성, GEO 마케팅
📞 문의: 010-3343-4000
🏢 듀온에듀 (출판)