OpenClaw 2026년 3월 업데이트 총정리 — PDF 분석 도구, 플러그인 SDK 확장, 보안 강화까지

mintorain 2026. 3. 6. 05:02

2026. 3. 6. 05:02

🦞 OpenClaw 최신 릴리스 핵심 변경사항

2026년 3월 초, OpenClaw의 대규모 업데이트가 릴리스되었습니다. AI 에이전트 게이트웨이로서의 역할을 한층 강화하는 다양한 기능이 추가되었는데요, 핵심 변경사항을 하나씩 살펴보겠습니다.

이번 업데이트의 하이라이트 중 하나는 퍼스트 클래스 PDF 분석 도구의 추가입니다.

바이브 코딩 워크플로우에서 기술 문서나 API 스펙을 PDF로 전달하면, 에이전트가 직접 읽고 이해한 후 코드를 작성할 수 있게 된 것입니다.

# PDF 분석 예시 (에이전트 도구 호출)
pdf:
  path: "./api-spec.pdf"
  prompt: "이 API 스펙에서 인증 엔드포인트를 추출해줘"

보안은 셀프호스팅 AI 게이트웨이에서 가장 중요한 요소입니다. 이번 업데이트에서는:

민감한 API 키나 토큰을 직접 설정 파일에 넣지 않고 SecretRef로 안전하게 관리할 수 있어, 팀 단위 운영에 특히 유용합니다.

OpenClaw의 확장성이 한층 강화되었습니다:

기능	설명
channelRuntime 노출	외부 채널 플러그인에서 공유 런타임 헬퍼(reply/routing/session) 접근 가능
STT API 추가	`api.runtime.stt.transcribeAudioFile()`로 로컬 오디오 파일 트랜스크립션
세션 라이프사이클	session_start/session_end 훅에 sessionKey 포함
메시지 라이프사이클	`message:transcribed`, `message:preprocessed` 훅 이벤트 추가
이벤트 구독	`runtime.events.onAgentEvent`, `onSessionTranscriptUpdate` 제공
하트비트 트리거	`runtime.system.requestHeartbeatNow()`로 즉시 세션 깨우기

이를 통해 커스텀 플러그인 개발자는 OpenClaw의 거의 모든 내부 이벤트에 접근하고 반응할 수 있게 되었습니다.

텔레그램 사용자에게 반가운 소식입니다:

설정 없이 바로 실시간 응답 스트리밍을 경험할 수 있다는 점이 핵심입니다.

새로운 MiniMax-M2.5-Highspeed 모델이 빌트인 프로바이더 카탈로그에 추가되었습니다. 기존 MiniMax-M2.5-Lightning과의 하위 호환성도 유지되어, 점진적으로 마이그레이션할 수 있습니다.

# 설정 검증 예시
openclaw config validate --json

# 결과: 잘못된 키 경로가 상세히 표시됨
# { "valid": false, "errors": [{ "path": "channels.telegram.streeming", ... }] }

업그레이드 시 반드시 확인해야 할 변경사항입니다:

도구 프로필 기본값 변경: 새 로컬 설치 시 tools.profile이 messaging으로 기본 설정. 코딩/시스템 도구를 사용하려면 명시적 설정 필요
ACP 디스패치 기본 활성화: 비활성화하려면 acp.dispatch.enabled=false 설정
Plugin SDK HTTP 핸들러: api.registerHttpHandler() 제거됨 → api.registerHttpRoute() 사용
Zalo Personal 플러그인: 외부 CLI 바이너리 의존성 제거, 업그레이드 후 openclaw channels login --channel zalouser 재실행 필요

OpenClaw는 단순한 챗봇 게이트웨이가 아닙니다. 바이브 코딩(Vibe Coding)의 핵심 인프라로 활용할 수 있습니다:

"코드를 쓰는 것이 아니라, AI와 대화하며 소프트웨어를 만드는 시대"에 OpenClaw는 그 대화의 채널이 됩니다.

이신우 (이사) | 미래연구소 https://lab.duonedu.net

📚 강의 분야: 바이브 코딩, 생성형 AI 생산성, GEO 마케팅
📞 연락처: 010-3343-4000
🏢 두원교육 (출판)