OpenClaw 2026.9.6 마이그레이션 노트: replace:true 청크, 폐기된 구성 키, 엄격한 세션 모델

OpenClaw 게이트웨이에 맞춰 커스텀 WebSocket 클라이언트를 유지보수하는 한 개발자가 릴리스 2026.9.1과 2026.9.6 사이의 세 가지 호환성 깨짐 변경 사항을 기록했다. 각각 시간을 잡아먹었기에, 핵심만 추려본다.

1. 최종 어시스턴트 청크의 replace:true

OpenAI 모델은 이제 codex 플러그인을 통해 실행된다. msg_… 항목 아래에서 답변을 스트리밍한 뒤, 게이트웨이는 새로운 itemId 아래에 replace:true와 동일한 전체 텍스트를 담은 stream=assistant 청크를 하나 더 보낸다.

클라이언트가 모든 새 itemId를 새 문단으로 취급하면, 모든 응답이 두 번 렌더링된다. 해결책은 replace 플래그를 존중하는 것 — 추가(append)하는 대신 이전 항목의 내용을 교체해야 한다.

2. agents.defaults.compaction.reserveTokensFloor 폐지

이 설정 키는 제거되었다. openclaw.json에 남아 있으면 설정이 유효하지 않은 것으로 보고된다: 모든 CLI 명령이 실행을 거부하고, 게이트웨이는 다음 재시작 후 다시 올라오지 않는다.

복구 명령:

openclaw config validate
openclaw doctor --fix

validate는 문제가 되는 키를 알려주고, doctor --fix는 이를 제거한다. 작성자는 이 키를 손으로 다시 추가했다가 또 망가뜨렸다고 한다 — 따라 하지 말 것.

3. 세션 모델은 폴백에 엄격하다

agents.defaults.model.fallbacks는 설정된 기본 모델만 보호한다. sessions.patch를 통해 세션별로 선택한 모델은 엄격하게 적용된다: 해당 제공자가 503을 반환하면, 폴백 체인을 타고 내려가지 않고 실행이 눈에 띄게 실패한다. 이는 문서화된 동작이다.

더 작은 변경 사항

• models.list는 전체 카탈로그가 아니라 agents.defaults.models에 있는 항목을 반환한다.
• chat.startup 기본값은 이제 제공자 필드를 modelProvider라고 부른다.

작성자는 9.7이나 9.8에서 다른 클라이언트 대상 변경 사항을 본 사람이 있는지 묻고 있다.