OpenClaw 최신 업데이트 총정리 — PDF 분석 도구, 텔레그램 스트리밍, 플러그인 SDK 확장

mintorain 2026. 3. 4. 05:02

2026. 3. 4. 05:02

🦞 OpenClaw 2026년 3월 최신 릴리스 하이라이트

AI 에이전트 게이트웨이 OpenClaw이 또 한 번 대규모 업데이트를 발표했습니다. 이번 릴리스는 PDF 분석 도구 신규 추가, 텔레그램 실시간 스트리밍 기본 활성화, 플러그인 SDK 대폭 확장 등 실무에서 바로 활용할 수 있는 기능들로 가득합니다.

📄 PDF 분석 도구 — 문서 이해의 새로운 차원

이번 업데이트의 핵심 중 하나는 first-class PDF 도구의 추가입니다.

Anthropic & Google 네이티브 PDF 지원 — Claude, Gemini 모델에서 PDF를 직접 분석
비네이티브 모델 폴백 — 다른 모델 사용 시 자동으로 텍스트/이미지 추출 후 분석
설정 가능한 옵션 — pdfModel, pdfMaxBytesMb, pdfMaxPages 등 세밀한 제어

계약서, 보고서, 논문 등 PDF 문서를 에이전트에게 직접 보내면 내용을 파악하고 요약해주는 워크플로우가 가능해졌습니다.

# 에이전트 설정 예시 (config.yaml)
agents:
  defaults:
    pdfModel: anthropic/claude-opus-4
    pdfMaxBytesMb: 25
    pdfMaxPages: 100

💬 텔레그램 실시간 스트리밍 기본 활성화

텔레그램 채널에서 AI 응답이 실시간으로 타이핑되는 것처럼 보이는 스트리밍 기능이 이제 기본값으로 설정됩니다.

partial 스트리밍 기본값 — 신규 설치 시 자동 활성화
DM 전용 sendMessageDraft — 개인 채팅에서 더 자연스러운 미리보기
Reasoning 분리 표시 — 추론 과정과 최종 답변이 별도 레인으로 표시

응답을 기다리는 동안 실시간으로 텍스트가 나타나므로, 체감 속도가 크게 향상됩니다.

🔌 플러그인 SDK — 개발자를 위한 확장성 강화

OpenClaw의 플러그인 생태계가 한층 강력해졌습니다.

새로운 Plugin Runtime API

API	기능
`runtime.stt.transcribeAudioFile()`	로컬 오디오 파일 텍스트 변환
`runtime.system.requestHeartbeatNow()`	즉시 세션 깨우기
`runtime.events.onAgentEvent`	에이전트 이벤트 구독
`channelRuntime` on Context	채널 런타임 헬퍼 직접 접근

Hook 이벤트 확장

message:transcribed — 음성 메시지 텍스트 변환 후 트리거
message:preprocessed — 전처리 완료 후 트리거
message:sent — 그룹 정보(isGroup, groupId) 포함
session_start / session_end — sessionKey 포함으로 세션 추적 가능

🔒 SecretRef 보안 강화 — 64개 타겟 전면 지원

사용자 자격 증명을 안전하게 관리하는 SecretRef가 이제 64개 설정 대상을 모두 커버합니다.

런타임 수집기, secrets planning/apply/audit 워크플로우 전체 지원
미해결 참조 시 활성 표면에서는 즉시 실패(fail fast)
비활성 표면에서는 비차단 진단 메시지 제공

API 키나 토큰을 설정 파일에 직접 노출하지 않고 안전하게 관리할 수 있습니다.

🚀 그 외 주목할 변경사항

MiniMax-M2.5-highspeed 모델 공식 지원 추가
서브에이전트 파일 첨부 — sessions_spawn에서 base64/utf8 인라인 첨부 가능
Ollama 임베딩 — 메모리 검색에 로컬 Ollama 임베딩 사용 가능
CLI config validate — 게이트웨이 시작 전 설정 파일 검증 명령어 추가
음성 메모 트랜스크립트 에코 — 음성 메시지 텍스트 변환 결과를 채팅에 확인 메시지로 전송

⚠️ Breaking Changes 주의사항

tools.profile 기본값 변경 — 신규 설치 시 messaging으로 기본 설정 (이전: 전체 도구)
ACP dispatch 기본 활성화 — 비활성화하려면 acp.dispatch.enabled=false 명시 필요
Plugin SDK HTTP 핸들러 변경 — registerHttpHandler 제거, registerHttpRoute 사용 필수

💡 바이브 코딩과 OpenClaw 활용 팁

OpenClaw은 단순한 챗봇이 아닌, 코딩 에이전트 게이트웨이입니다. 바이브 코딩(Vibe Coding) 워크플로우에서 특히 강력한 시너지를 발휘합니다.

텔레그램에서 코드 리뷰 요청 → AI 에이전트가 PR 분석 후 피드백
PDF 스펙 문서 전송 → 자동 분석 후 구현 코드 생성
ClawHub 스킬로 GitHub Issues 자동 처리, 날씨 알림, 보안 점검 등 확장
멀티 에이전트 라우팅으로 작업별 전문 에이전트 분배

자연어로 대화하듯 개발하는 시대, OpenClaw과 함께 시작해보세요.

📌 안내

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

강의 분야: 바이브 코딩(Vibe Coding), 생성형 AI 생산성, GEO 마케팅

연락처: 010-3343-4000

두원교육 (출판)

미래이음연구소