OpenClaw 2026.2.24 릴리즈 노트 분석

한 줄 요약

하트비트·크론이 DM으로 새어나가는 문제를 근본적으로 막았고, fallback 체인이 중간에 끊기던 버그가 수정됐다.

출처: https://github.com/openclaw/openclaw/releases/tag/v2026.2.24

 

주요 변경사항

1. 하트비트가 DM으로 못 간다 (Breaking)

공식 노트: Heartbeat delivery가 direct/DM 타겟을 차단한다. 하트비트 실행은 되지만, DM 대상으로는 메시지가 전송되지 않는다.

하트비트가 텔레그램 DM이나 WhatsApp 개인 채팅으로 쏟아지는 걸 막았다. 이전 버전에서는 하트비트가 의도치 않게 DM으로 흘러들어가는 경우가 있었다. 이제 채널/그룹 타겟만 허용된다. 하트비트 결과를 DM으로 받고 있었다면 이번 업데이트 이후 안 올 수 있다. 채널이나 그룹을 delivery 타겟으로 바꿔야 한다.

2. Docker 컨테이너 네임스페이스 공유 차단 (Breaking)

공식 노트: sandbox/sandbox-browser 컨테이너에서 network: "container:" 모드가 기본 차단된다.

Docker 기반 sandbox를 쓰는 경우에만 해당된다. 컨테이너끼리 네트워크 네임스페이스를 공유하는 건 보안 위험이 있어서 기본값이 차단으로 바뀌었다. 의도적으로 쓰고 있었다면 dangerouslyAllowContainerNamespaceJoin: true 플래그를 명시해야 한다. 로컬 환경(Docker 미사용)이면 무관하다.

3. 다국어 정지 명령어 확장

공식 노트: "stop openclaw", "please stop" 등 정지 명령어가 확대되고, 한국어·일본어·중국어 등 다국어 지원이 추가됐다.

에이전트가 엉뚱한 방향으로 갈 때 멈추는 명령어가 다양해졌다. "STOP OPENCLAW!!!" 같은 느낌표 포함도 인식한다. 다만 일반 대화에서 "stop"이 포함된 문장이 오탐되지 않도록 독립 단어 매칭을 유지한다.

4. fallback 체인 중간 탈락 버그 수정

공식 노트: fallback 모델로 실행 중일 때, 설정된 fallback 체인을 계속 따라가도록 수정. primary만 재시도하다 실패하는 문제 해결.

fallback 설정을 [A, B, C]로 했을 때 A가 rate limit에 걸려 B로 넘어갔는데, B도 실패하면 다시 A만 시도하고 C는 건너뛰는 버그가 있었다. 이번 수정으로 B 실패 시 C까지 쭉 내려간다. fallback 체인을 길게 설정해놓은 사용자에게 특히 중요한 수정이다.

5. 하트비트 중복·누수 방지 (다수 이슈 수정)

여러 PR에 걸쳐 하트비트 관련 버그가 대거 수정됐다:

• 중복 실행 방지: 이미 실행 중인 세션에 하트비트가 큐에 쌓이지 않는다
• 스레드 누수 방지: 하트비트가 활성 대화 스레드로 흘러들어가지 않는다
• DM 누수 방지: Discord 등 DM 채널로 하트비트가 전송되지 않는다
• 기본값 변경: 하트비트 delivery 기본 타겟이 last에서 none으로 변경됐다 (명시적 opt-in 필요)

하트비트 자동화를 쓰고 있다면 delivery 설정을 다시 확인해야 한다.

6. 라우팅/세션 격리 강화

공식 노트: 크로스채널 응답의 세션 격리 강화. webchat/control-ui 컨텍스트가 Discord 타겟 응답을 가로채는 문제 수정.

텔레그램에서 보낸 메시지의 응답이 Discord로 가거나, Control UI에서 테스트한 응답이 다른 채널로 새어나가는 문제가 수정됐다. 멀티채널 운영 시 각 채널의 응답이 정확히 해당 채널로만 돌아간다.

7. typing 인디케이터 유지

공식 노트: 긴 응답 중 typing 콜백을 keepalive 간격으로 갱신한다.

에이전트가 긴 글을 쓰는 동안 "입력 중..." 표시가 중간에 사라지던 문제가 해결됐다. 사소하지만 사용자 경험에 영향이 있다.

8. Android 앱 UX 개편

온보딩 4단계 네이티브 플로우, 5탭 쉘 구조(Connect, Chat, Voice, Screen, Settings)로 개편됐다. Android 사용자라면 UI가 눈에 띄게 달라졌을 것이다.

9. Discord Voice/DAVE 안정성 개선

Discord 음성 채팅의 DAVE 암호화 관련 안정성이 크게 개선됐다. 음성 인식 중 복호화 실패 시 자동 재접속하는 복구 로직이 추가됐다. 10개 이상의 관련 이슈가 한꺼번에 해결된 것으로 보아, 그만큼 문제가 많았다는 뜻이다.

마이그레이션 주의사항

• 하트비트 DM 타겟 사용자: delivery 타겟을 채널/그룹으로 변경 필요
• 하트비트 delivery 기본값: last → none 변경됨. 외부 전달이 필요하면 명시적으로 설정해야 한다
• Docker sandbox 사용자: 컨테이너 네임스페이스 공유를 의도적으로 쓰고 있었다면 플래그 추가 필요

참고 링크

• 릴리즈 페이지
• Model Failover 공식 문서
• Multi-Agent Routing 공식 문서

운영 메모

fallback 체인 버그 수정(#25922)은 직접 겪었던 문제다. fallback 목록을 6~7개 넣어놨는데 중간에서 멈추고 primary로만 돌아가는 현상이 있었다. 이번 버전에서 해결됨.