OpenClaw 2026.2.25 릴리즈 노트 분석

한 줄 요약

전 버전(2024.2.24)에서 도입한 하트비트 DM 차단 기본값을 되돌렸고, typing indicator가 끝없이 돌던 버그를 여러 PR에 걸쳐 완전히 수정했다.

---

주요 변경사항

1. 하트비트 DM 기본값 복구 (Breaking)

공식 노트: 하트비트 direct/DM delivery 기본값이 다시 allow로 돌아왔다. 2026.2.24의 차단 동작을 유지하려면 agents.defaults.heartbeat.directPolicy: "block"을 명시해야 한다.

실제로 뭔 얘기냐: 2026.2.24에서 하트비트가 DM으로 가는 걸 기본 차단으로 바꿨는데, 이번에 다시 원래대로(허용) 되돌렸다. 업데이트 직후 텔레그램 개인 DM으로 하트비트가 안 오는 걸 경험했다면 이번 버전에서 복구된다. 반대로 "DM으로 오면 안 된다"고 명시적으로 설정했던 사람은 directPolicy: "block" 설정을 추가해야 기존 동작이 유지된다.

새 설정 구조:

"agents": {
  "defaults": {
    "heartbeat": {
      "directPolicy": "block"
    }
  }
}

에이전트별 개별 설정도 가능하다 (agents.list[].heartbeat.directPolicy).

2. config 편집 전 config.schema 확인 권장

공식 노트: 에이전트에게 config 편집이나 config 필드 관련 질문 전에 config.schema를 먼저 조회하도록 안내가 추가됐다.

실제로 뭔 얘기냐: config 키 이름을 감으로 추측하다가 게이트웨이가 멈추는 사고를 방지하기 위한 변화다. 에이전트(또는 사용자)가 config를 수정하기 전에 openclaw config schema로 올바른 구조를 확인하는 게 정석이 됐다.

---

버그 수정

1. Typing indicator 완전 수정 (3개 PR)

공식 노트: Discord, 기타 채널에서 typing indicator가 멈추지 않던 버그를 여러 경로에서 막았다 (#26295, #26325, #26881).

실제로 뭔 얘기냐: 에이전트가 응답을 마쳤는데 "입력 중..." 표시가 계속 남아있던 문제다. 원인은 세 가지 경로에 있었다:

1. idle/cleanup 후에도 keepalive 콜백이 재실행됨
2. preview-stream cleanup 실패 시 Discord typing idle 처리 누락
3. NO_REPLY, 빈 응답, 에러 등 종료 경로에서 typing idle 처리 누락

2026.2.24에서 typing keepalive 자체가 추가됐고, 2026.2.25에서 그 cleanup 경로가 완성됐다. 업데이트 후 게이트웨이 재시작 필수.

2. Subagent 완료 알림 전달 개선

공식 노트: subagent 완료 알림 발송 로직을 명시적인 상태 머신으로 리팩토링. 플러그인 레지스트리가 stale 상태일 때 채널 전달이 실패하던 문제 수정.

실제로 뭔 얘기냐: 서브에이전트가 작업을 마쳤는데 완료 알림이 안 오거나 중복으로 오던 문제가 개선됐다. Telegram에서 message_id 없이 전송된 경우를 "성공"으로 잘못 처리하던 것도 수정됐다.

3. Telegram webhook 안정성

공식 노트: webhook 봇 사전 초기화, 콜백 모드 전환, 페이로드 크기 제한 근처에서의 읽기 보존.

실제로 뭔 얘기냐: Telegram webhook 방식으로 운영할 때 요청이 중간에 끊기거나 업데이트가 누락되던 문제가 수정됐다. 폴링 방식이면 무관하다.

4. Slack 세션 스레드 오버플로 보호

공식 노트: 부모 세션이 너무 클 때 새 스레드 세션이 조용히 깨지는 문제 수정. session.parentForkMaxTokens 설정 추가 (기본 100000).

실제로 뭔 얘기냐: Slack에서 스레드 대화가 갑자기 안 되는 경우 컨텍스트 오버플로가 원인일 수 있었다. 이제 명시적으로 에러 메시지가 표시되고 토큰 한도도 설정 가능하다.

5. Cron 멀티 계정 라우팅 수정

공식 노트: isolated cron delivery에서 delivery.accountId가 무시되던 문제 수정. accountId 생략 시 global account 대신 해당 에이전트의 채널 계정으로 fallback.

실제로 뭔 얘기냐: 멀티 에이전트 + 멀티 계정 환경에서 크론잡 알림이 엉뚱한 계정으로 가던 문제다. 에이전트별로 Telegram/Discord 계정을 다르게 쓰는 경우 이 수정이 중요하다.

6. Discord embed 제목 누락 수정

공식 노트: Discord embed의 title + description fallback이 에이전트 입력에서 사라지던 문제 수정.

실제로 뭔 얘기냐: Discord에서 링크 임베드가 붙은 메시지를 보냈을 때 에이전트가 임베드 제목을 못 읽던 문제가 해결됐다.

---

마이그레이션 주의사항

• 2026.2.24에서 하트비트 DM 차단했던 경우: directPolicy: "block" 명시 필요. 안 하면 다시 DM으로 하트비트가 전송된다.
• 이번 버전도 게이트웨이 재시작 필요: typing indicator 수정이 새 코드 적용 후에만 동작한다.

---

참고 링크

• 릴리즈 페이지
• Model Failover 공식 문서
• Cron Jobs 공식 문서

---

운영 메모

typing indicator 버그는 방금 게이트웨이 재시작으로 직접 확인했다. 2026.2.24 업데이트 후에도 재시작 전까지 증상이 남아있었다 — 업데이트 후 재시작이 필수인 이유.