들어가며

OpenClaw 3.7 릴리즈가 드디어 배포됐습니다. 이번 버전의 핵심 테마를 세 줄로 요약하면:

  1. Context Engine 플러그인화 — 봇의 기억력을 통째로 커스텀하는 시대
  2. ACP 영구 바인딩 & Telegram 라우팅 — 서브에이전트 생존력과 채널 매니징의 끝판왕
  3. 경량화와 최적화 — Docker Multi-stage 빌드와 프롬프트 토큰 다이어트

눈여겨볼 변화들이 꽤 많습니다. 하나씩 뜯어보겠습니다.

1. 🧠 Context Engine 플러그인 슬롯 신설 (자유도 무한대)

(Thanks @jalehman)

플랫폼의 근본을 건드리는 패치입니다. ContextEngine 플러그인 슬롯과 전체 라이프사이클 훅(bootstrap, ingest, assemble, compact 등)이 추가됐습니다.

  • lossless-claw 같은 외부 플러그인이 코어 압축(compaction) 로직을 아예 대체할 수 있게 됐습니다.
  • 물론 플러그인 설정이 없으면 기존 압축 로직이 LegacyContextEngine을 통해 100% 동일하게 동작하니 안심하셔도 됩니다.

2. 🔌 ACP 영구 바인딩 & Telegram 라우팅 고도화

서브에이전트(ACP)와 채널 관리 기능이 대폭 상향됐습니다.

  • ACP 영구 채널 바인딩 (Thanks @dutifulbob): Discord 채널이나 Telegram 토픽 바인딩 정보가 이제 스토리지에 저장되어, 서버가 재시작되어도 ACP 스레드 타겟이 살아남습니다.
  • Telegram 토픽 에이전트 라우팅 (Thanks @kesor, @Sid-Qin): 포럼 그룹이나 DM 토픽별로 agentId를 덮어씌울 수 있습니다. 즉, 채널 하나 안에서 “코딩용 토픽”, “번역용 토픽"을 파서 완전히 독립된 세션으로 운영할 수 있습니다.
  • Telegram Mac 대시(-) 지원 & UX 개선 (Thanks @huntharo): /acp spawn 명령어 강화, 승인 버튼 연동, 성공 알림 고정(pin) 기능까지 텔레그램 UX가 엄청나게 좋아졌습니다.

3. ⚡ Google Gemini 3.1 Flash-Lite 공식 지원

경량형 모델의 샛별, google/gemini-3.1-flash-lite-preview가 1급 시민으로 합류했습니다. 모델 ID 정규화, 기본 별칭(alias), 미디어 이해(이미지 룩업), 그리고 호환성 폴백까지 모두 지원합니다. 가볍게 굴릴 때 API 비용을 확 아낄 수 있는 선택지가 생겼습니다.

4. 🐳 Docker / Podman 최적화 (다이어트 & 스피드)

(Thanks @sallyom)

컨테이너 배포 환경이 환골탈태했습니다.

  • 의존성 미리 굽기 (OPENCLAW_EXTENSIONS): NPM 확장팩들을 이미지 빌드 단계에서 미리 설치해서, 컨테이너 부팅 속도가 획기적으로 빨라졌습니다.
  • Multi-stage 빌드: 빌드 툴, 소스코드, Bun 런타임 등을 전부 걷어낸 초경량 런타임 이미지를 생성합니다. OPENCLAW_VARIANT=slim 빌드 인자로 bookworm-slim 변형도 선택 가능합니다.

5. 🔍 Web Search 개편 & 온보딩 마법사

(Thanks @kesku, @thewilloftheshadow)

  • 온보딩 마법사 개선: 최초 설정 마법사에서 프로바이더 전체 목록을 보고 선택할 수 있으며, SecretRef 방식도 완벽 지원합니다.
  • Perplexity 업데이트: 기존 공급자가 Search API 기반으로 넘어가면서, 구조화된 결과와 함께 새로운 언어/지역/시간 필터를 적용할 수 있게 됐습니다.

6. 📉 훅(Hook) & 프롬프트 최적화 (토큰 다이어트)

  • 시스템 컨텍스트 캐싱 (Thanks @maweibin): prependSystemContext와 appendSystemContext가 추가되어 정적 플러그인 가이드를 시스템 프롬프트 공간에 배치할 수 있습니다. 프로바이더 캐싱 효과가 극대화되어 반복 토큰 비용이 뚝 떨어집니다.
  • Diffs 툴 가이드 분리 (Thanks @sircrumpet, @gumadeiras): Diffs 사용법 가이드를 무조건 쏘는 대신 컴패니언 스킬 경로로 뺐습니다. 프롬프트 노이즈가 크게 줄어듭니다.
  • Compaction 훅 이벤트 (Thanks @vincentkoc): session:compact:before / after 훅이 생겨서, 압축 주기에 맞춰 자동화 스크립트를 우아하게 끼워 넣을 수 있습니다.

7. 🛠️ 기타 눈에 띄는 편의성 개선

  • Slack 소켓 모드 타이핑 리액션 (Thanks @dalefrieswthat): Slack 네이티브 타이핑 표시가 불가능할 때, 이모지 리액션으로 봇의 상태를 보여줍니다.
  • Discord 멘션 강제 (allowBots) (Thanks @thewilloftheshadow): 봇이 보낸 메시지라도, 봇을 명시적으로 멘션할 때만 응답하게 막을 수 있습니다.
  • Gateway SecretRef 지원 (Thanks @joshavant): gateway.auth.token에 시크릿 참조(SecretRef) 방식을 공식 지원합니다.
  • 스페인어(es) UI 지원 (Thanks @DaoPromociones): Control UI에 스페인어 로케일이 추가됐습니다.
  • Cron 작업 스냅샷 복구 (Thanks @0xsline): 에디터 작업 전의 jobs.json.bak 스냅샷을 보존하여 롤백이 쉬워졌습니다.

마무리

이번 3.7 버전은 외형적인 화려함보다는 **“확장성(Context Plugin, Hooks)”**과 **“실무 안정성(Docker Slim, ACP 영구 바인딩, Token Caching)”**에 집중한, 매우 공학적으로 단단한 업데이트입니다.

서버를 껐다 켜도 ACP 스레드가 살아있다는 점, 그리고 플러그인으로 압축 로직을 뜯어고칠 수 있다는 점만으로도 업데이트할 가치는 충분합니다.

업데이트는 언제나처럼:

openclaw update

그럼 모두 즐거운 해킹 되시길! 🚀