OpenClaw 2026.11.5 업데이트 전체 정리: Changes 4개와 Fixes 36개
2026년 11월 18일
제휴 고지: 이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.
OpenClaw 2026.11.5는 Gateway를 재시작해도 대화와 권한 상태가 유지되도록 만드는 안정성 개선, 업데이트 실패 시 되돌리는 복구 흐름 강화, Telegram 위젯 지원, 그리고 Cron·Telegram·모델 공급자 관련 수정이 폭넓게 들어간 릴리스입니다. 이 글에서는 changelog의 Highlights, Changes, Fixes 항목을 빠짐없이 한국어로 풀어 정리합니다.
이번 릴리스의 하이라이트
- 재시작에도 끊기지 않는 대화: 대기 중인 메시지, 전송 권한, 마지막 채팅 기록 쓰기가 Gateway를 재시작해도 유지됩니다. (#196923, #196540, #196493) 작성: @steipete, 감사: @joshavant.
- 더 안전한 업데이트: Doctor 점검이나 Gateway 시작에 실패하면 활성화된 업데이트를 이전 상태로 되돌리고, 복원된 npm 패키지는 root가 아닌 서비스에서도 읽을 수 있습니다. (#197851, #193272) 감사: @RomneyDa, @obviyus, @vincentkoc.
- Telegram 위젯: 인터랙티브 위젯이 Telegram 메시지에서 표시되며, 비공개 채팅의 토픽에서도 동작합니다. (#196991, #198022, 관련 #197923) 감사: @obviyus, @dankarization.
- 빨라진 메모리 복구: 대용량 메모리 인덱스 재구성이 안정적으로 끝나고, 게이트웨이가 배치 한도 오류를 잘라 전달해도 임베딩 인덱싱이 복구됩니다. (#196378, #187797, 관련 #187788) 감사: @TameTheGame, @RomneyDa, @vincentkoc, @garrytan, @obviyus, @fredtanxo.
- 더 믿을 수 있는 모델 대체 경로: 기본으로 설정한 계정이 Claude CLI 대체 실행을 막지 않으며, OpenAI 세션은 컴팩션 항목 충돌에서 스스로 복구합니다. (#198427, #198357, 관련 #158421) 작성: @steipete, 감사: @RomneyDa, @obviyus, @alkor2000, @HerbertHuerto.
- 쓸 수 있는 기기 폴더: 기본 런타임에서도 기존 기기 폴더를 선택할 수 있고, 폴더 선택 항목이 간결한 메뉴 행으로 보입니다. (#190065, #190088) 감사: @RomneyDa, @obviyus.
- 콘텐츠 경계 보호: 바이너리 첨부 파일이 깨진 문자로 프롬프트에 들어가지 않고, 인증 정보가 포함된 브라우저 CDP URL이 도구 결과에 노출되지 않습니다. (#198309, #196262, 관련 #198289) 감사: @Yun-0000, @obviyus, @mulderp82, @PollyBot13, @sallyom.
Changes 전체 목록 (4개)
- 바쁜 세션 메시지와 보안 프리셋 — 개인 모드에서 세션이 작업 중일 때 보낸 메시지는 호환되는 작업이면 진행 중인 흐름을 조정하고, 아니면 조용히 대기열에 들어갑니다. 더 이상 직접 다시 보낼 필요가 없습니다. 개인용·기업용 보안 프리셋은 서로 일관된 기본값을 제공하되, 사용자가 명시한 설정과 필수 접근·승인 제한은 그대로 적용됩니다. (#185477) 작성: @steipete, 감사: @joshavant.
- 컴팩션 —
maxSummaryChars설정으로 컴팩션 요약의 글자 수 상한을 직접 지정할 수 있습니다. (#196207, 관련 #194408) 감사: @aniruddhaadak80, @RomneyDa, @garrytan. - Knowledge — 지식 페이지를 한 번에 읽을 수 있는 크기 안에서 유지하고, 지나치게 큰 페이지 전체를 불러오지 않고도 필요한 섹션만 추출할 수 있습니다. (#186270) 감사: @jalehman.
- Breaking: 하네스와 플러그인의 세션 제어 방식 변경 — 서드파티 하네스는 세션 키 기반의 활성 실행을 호스트의
runAttempt콜백 안에서 등록하고, 반환된 정리(cleanup) 함수를 반드시 보관해야 합니다. 플러그인 RPC 핸들러는chatAbortControllers와chatQueuedTurns대신 권한이 확인된 Gateway 메서드 디스패치를 사용해야 합니다. 시작 소유자 관측값은expiresAtMs대신startDeadlineAtMs를 쓰며, 번들된 소비자는 이미 새 방식으로 옮겨졌습니다. (#175837) 작성: @steipete, 감사: @RomneyDa, @vincentkoc, @jalehman.
Fixes 전체 목록 (36개)
권한·대화·Gateway
- Authorization — 대기열에 있던 자동화 실행이 시작되기 전에 소유자 전용 메모리에 대한 접근 권한을 다시 확인합니다. 또한 실패한 하위 작업의 결과는 부모 턴이 끝난 뒤에도 전달될 수 있습니다. (#198697, #197658, 관련 #198695) 감사: @RomneyDa, @daniel-lxs, @obviyus.
- Conversation history — 새로 고침을 해도 키가 붙은 코멘터리가 유지되고, 데이터베이스 준비가 동시에 진행되어도 대화 기록 읽기가 끊기지 않으며, 완료됐지만 내용이 빈 시도가 기록을 어지럽히지 않습니다. (#188180, #188055, #188111) 감사: @RomneyDa, @vincentkoc, @fuller-stack-dev, @jalehman.
- Gateway recovery — 워크스페이스 준비가 끝난 뒤 중단됐던 턴을 이어서 실행하고, 재시작 의도가 지연되어도 정상 종료 절차를 지키며, 업로드는 워크스페이스 준비 전에 먼저 수신 확인을 보냅니다. (#196423, #188047, #188728) 작성: @steipete, 감사: @RomneyDa, @TameTheGame, @vincentkoc.
- Gateway reload — 파일 감시기가 리로드 경쟁에서 먼저 반응해도 설정 업데이트가 멈추지 않으며, 종료가 시작되면 MCP 리스너 작업이 취소됩니다. (#192701, #197119) 감사: @RomneyDa, @zeroaltitude, @obviyus.
Cron과 자동화
- Cron scheduling — 예약 작업에 지정한 계정 선택이 유지되고, 재시도 기한과 완료 실행의 식별자가 재시작 후에도 보존됩니다. 스케줄러가 늦게 깨어나도 작업이 조용히 사라지지 않고 처리됩니다. (#180677, #197449, #197484) 감사: @RomneyDa, @vincentkoc, @giodl73-repo, @Stronggenetics, @obviyus.
- Cron lifecycle — 설정을 핫 리로드해도 실행 중인 작업이 중단되지 않으며, 시작 기한과 취소 기능이 계속 유효하고, 자동 스케줄링을 끄면 유휴 워커가 해제됩니다. (#197606, #188982, #196387, 관련 #197591) 작성: @steipete, 감사: @vincentkoc, @RomneyDa, @obviyus, @wupingyuan81-oss.
- Quiet automations — 조건이 거짓인 트리거 점검은 채팅에 나타나지 않고, 메인 세션 자동화를 DM에서 실행해도 모델 호출 전에 실패하지 않습니다. (#188594, #188700, #180603, 관련 #180602, #197181) 작성: @steipete, 감사: @RomneyDa, @masatohoshino, @obviyus, @Suiah98.
Telegram과 채널
- Telegram replies and approvals — 진행 스트림 모드에서 ACP 답장이 다시 표시되고, 승인 요청이 해당 비공개 채팅이나 포럼 토픽 안에 머뭅니다. (#197191, #198038, #192162, 관련 #195899, #197907, #125166) 감사: @bach205, @obviyus, @dankarization, @claxman, @Waste2Time.
- Telegram hooks and controls — 전달 훅에 런타임 세션 키를 넘겨주고, 비활성화된 버튼은 눌러도 반응하지 않는 형태로 표시됩니다. (#197519, #191647, 관련 #197186, #197669, #191645) 감사: @lester076, @obviyus, @rodricksz4h5, @tommyjoseph, @aspalagin.
- Channels — Feishu에서 블록 스트리밍을 끈 상태에서도 캡션이 붙은 미디어가 전달되고, Matrix와 Mattermost의 디렉터리 검색은 유니코드 정규화 차이를 맞춰 일치시키며, 조작된 Matrix 서식이 멘션 검사를 지연시키지 못하도록 막았습니다. (#191585, #187881, #187199, #184432) 감사: @RomneyDa, @forrystudio, @xialonglee, @obviyus, @wangmiao0668000666, @LeizhenZhang.
음성·UI·데스크톱
- iOS voice — 휴대폰이 잠긴 상태에서도 Talk가 계속 동작하고, 음성 인식 권한의 허용 버튼을 눌렀을 때 앱이 종료되던 문제를 고쳤습니다. (#187864, #196822, 관련 #185664) 감사: @RomneyDa, @brianmcguire, @ultrakorne, @obviyus.
- Talk startup — 음성 요청이 백엔드 에이전트 시작 전에 멈추지 않으며, 시작 등록에 실패하면 점유하던 자원을 해제합니다. (#183586, #187840, 관련 #187838) 감사: @RomneyDa, @bdjben, @brokemac79, @shakkernerd.
- Control UI — 열리는 중인 메뉴를 교체할 때 WebKit이 멈추는 현상을 막고, 채팅 상세 정보가 갱신될 때 이벤트 리스너 오류가 생기지 않도록 했습니다. (#198658, #198380) 감사: @fuller-stack-dev.
- Host desktop — 준비 상태 점검 중 VNC 인증을 끝까지 마쳐서, 반복 점검이 서버 잠금을 유발하지 않습니다. (#193487, 관련 #193444) 감사: @SebTardif, @obviyus, @lakemike.
- Keyboard and search — 워크트리 선택기에서 IME 탐색이 유지되고, 입력창으로 바로 이동하는 키보드 건너뛰기 기능이 생겼으며, 유니코드상 동일하게 취급되는 첨부 파일 이름도 검색에서 일치합니다. (#187732, #180896, #187674) 감사: @RomneyDa, @ooiuuii, @obviyus, @goutamadwant, @LiuwqGit, @huwei-xydt.
- UI responsiveness — 세션을 반복해서 전환할 때 WebKit이 점점 느려지는 문제를 줄이고, 정적 로딩 애니메이션 자원을 해제하며, 중단된 data-URL 미리보기를 정상 상태로 마무리합니다. (#194027, #194146, #191451) 작성: @steipete, 감사: @RomneyDa, @vincentkoc, @wangjx-xydt.
모델·공급자
- Provider continuity — 인증 소스나 모델을 바꿔도 공급자 체크포인트가 계속 사용 가능한 상태로 남습니다. (#200063, #200208) 감사: @obviyus.
- OpenAI and Anthropic — 훅이 요청을 덮어써도 저장된 컨텍스트 재생이 유지되고, 완료 웨이크와 메시지 경로가 바뀌어도 Anthropic 세션 프롬프트가 안정적으로 유지됩니다. (#199451, #197835, #197925) 감사: @RomneyDa, @vincentkoc, @vyctorbrzezowski, @obviyus.
- Claude CLI and providers — 라이브 세션 정리에 실패한 뒤에도 복구되고, 로컬 전송 장애가 정리된 뒤 다시 연결하며, Anthropic 모델을 고정하지 않아도 Claude CLI 모델이 목록에 포함됩니다. (#198224, #187375, #191148, 관련 #195431, #187023) 감사: @obviyus, @mdarapour, @wtfichigo, @etzelm, @Takhoffman.
- Model discovery — 모델 설정이 매우 클 때 읽기가 느려지는 문제를 피하고, SDK를 동시에 가져오는 상황에서도 공급자 탐색이 복구됩니다. (#198837, #196448, 관련 #195477) 감사: @RomneyDa, @vincentkoc, @1052326311, @WG-Mojo.
- Provider routing — OpenRouter 요청이 자체 엔드포인트에 머물고, 설정을 저장할 때 모델이 몰래 API 키 과금 방식으로 바뀌지 않습니다. (#185294, #191326, 관련 #185272) 감사: @vishnusenthil-16, @obviyus, @etzelm.
- Rate limits — 도구 실행 이후 설정된 최대 재시도 지연 시간을 지켜서, 지나치게 긴 대기로 세션 레인을 붙잡고 있지 않습니다. (#197611, 관련 #168101) 작성: @steipete, 감사: @kringsc.
Doctor·업데이트·백업
- Doctor and upgrades — Doctor 시작 시 대기 시간에 상한을 두고, SIGTERM을 존중하며, 호스팅 환경 점검이 라이브 세션을 멈추게 하지 않습니다. (#187936, #191125) 작성: @steipete, 감사: @RomneyDa, @vincentkoc.
- Update reliability — Doctor가 진행 상황을 확인하는 동안에도 데이터베이스 복원 기능을 유지하고, 무해한 빈 WAL 전환을 허용하며, 실패한 플러그인 후 Doctor 경고를 보존하고, 업데이트 후 점검 전에 Gateway가 정상 시작됐는지를 인식합니다. (#192083, #193134, #192942) 작성: @steipete, 감사: @TameTheGame, @RomneyDa, @vincentkoc, @fuller-stack-dev.
- macOS onboarding — 설치 프로그램의 터미널 인계 상태를 유지하여, 온보딩 중 플러그인을 설치할 때 분리된 npm 터미널 때문에 실패하지 않습니다. (#200247, 관련 #200244) 감사: @RomneyDa, @vincentkoc, @miguelbranco80.
- Stored state — 이름이 바뀐 에이전트의 콜드 대화 기록을 복구 전에 되살리고, 삭제된 에이전트의 보존 데이터베이스가 남아 있어도 문제없이 처리하며, 보류 중인 데이터베이스는 명시적으로 복원하기 전까지 분리해 둡니다. (#196079, #198145, #198180, 관련 #196066) 작성: @steipete.
- Backups — 스냅샷 압축을 스테이징 디렉터리 안에서 수행하고, 실제 데이터베이스를 복사하지 않고 백업 엔진을 점검하며, SQLite 손상 진단 정보를 보존합니다. (#194230, #194234, #194497, 관련 #194208, #194209) 작성: @steipete, 감사: @GoatInAHat.
- Backup diagnostics — 백업 수집 중 사용 중인 파일을 식별해 알려주고, 일시적인 Windows 접근 실패는 무결성 검사를 약화하지 않으면서 재시도합니다. (#193685) 작성: @steipete, 감사: @wr-web.
- Update recovery — 상태 경로 별칭, 라이브 정리 중 쓰기, 환경 변수로만 지정한 서비스 오버라이드가 있어도 복원 진행 상황을 잃지 않습니다. (#189004, #189628, #196371) 작성: @steipete, 감사: @RomneyDa.
- Update cleanup — 남아 있는 스냅샷 사본이나 NFS 스냅샷 디렉터리 정리 때문에 생기던 잘못된 실패 판정을 없애고, 리허설 중에도 외부 플러그인 데이터를 보존합니다. (#193702, #195409, #196301, 관련 #195396) 감사: @RomneyDa, @fuller-stack-dev, @tianping.
저장소·메모리·패키지
- Cold storage and startup — 대용량 대화 인덱스를 복구할 때 워커 메모리 부족으로 실패하던 문제를 피하고, 유휴 리더가 닫힌 뒤에도 콜드 PostgreSQL 대화를 복원하며, Gateway 시작 중 데이터베이스 복제가 멈추는 현상을 막습니다. (#194099, #189991, #190918) 작성: @steipete, 감사: @TameTheGame, @RomneyDa, @vincentkoc, @etzelm, @Frosmans.
- Memory and SQLite — Dreaming이 같은 목록을 중복해서 읽지 않게 하고, 완료된 SQLite 리더를 해제하며, 커서가 처음부터 다시 시작되는 문제를 막습니다. (#180692, #190242, 관련 #180657) 감사: @chelsealong, @obviyus, @lisandromachado, @ava-perry.
- Plugin rebuilds — 플러그인을 다시 빌드할 때마다 Gateway 메모리가 불어나지 않도록, 더 이상 쓰지 않는 플러그인 세대의 상태를 해제합니다. (#199042) 감사: @etzelm, @Patrick-Erichsen.
- Packages and discovery — PostgreSQL 타입 선언을 패키지에 포함하고, 패키지된 플러그인 export가 컴파일된 런타임 파일을 가리키게 하며, npm 설치 환경에서 Bonjour 탐색을 복원합니다. (#188091, #188639, #199156) 작성: @steipete, 감사: @RomneyDa, @vincentkoc, @galiniliev, @alfredjbclaw.
- Browser and workflow paths — 네이티브 CORS preflight 요청을 그대로 보존하고, Lightpanda 탐색 시간 초과를 피하며, 워크플로 경로에 포함된 공백을 잘라내지 않고 문자 그대로 유지합니다. (#185028, #196400, #187785) 작성: @steipete, 감사: @vincentkoc, @RomneyDa, @eleqtrizit, @wangmiao0668000666, @obviyus.
- CLI and configuration — 셸 자동 완성에서 도움말 플래그를 제안하고, JSON과 YAML에서 점(.) 경로로 값을 삽입할 수 있으며, 인터럽트 시 대기 중인 cron 목록 조회를 중단합니다. (#187799, #187828, #187726) 감사: @bajiaoshan, @obviyus, @LinzeShi, @SunnyShu0925.
사용자 입장에서 달라지는 점
- Gateway를 재시작하거나 업데이트해도 대기 중인 메시지와 대화 기록이 더 안정적으로 유지됩니다.
- 업데이트 중 Doctor나 Gateway 시작이 실패하면 자동으로 이전 상태로 돌아가므로, 업데이트 실패 시 서비스가 멈춘 채 남을 가능성이 줄어듭니다.
- Telegram에서 위젯이 보이고, 승인 요청과 ACP 답장이 올바른 토픽 안에서 처리됩니다.
- Cron과 자동화는 설정 리로드, 늦은 스케줄러 깨어남, DM 실행 같은 경계 상황에서 더 예측 가능하게 동작합니다.
- 모델 대체 경로(Claude CLI, OpenAI, OpenRouter, Anthropic)가 더 안정적이며, 설정 저장이 과금 방식을 바꾸지 않습니다.
- 개인 모드에서는 바쁜 세션에 보낸 메시지를 다시 보낼 필요가 줄어듭니다.
업데이트 전 체크할 점
- Breaking 변경 확인: 서드파티 하네스나 자체 플러그인을 운영한다면
runAttempt콜백 안에서 세션 키 기반 활성 실행을 등록하고 cleanup 함수를 보관하는지 확인하세요.chatAbortControllers,chatQueuedTurns를 쓰는 플러그인 RPC 핸들러는 Gateway 메서드 디스패치로 바꿔야 합니다.expiresAtMs를 참조하던 코드는startDeadlineAtMs로 옮겨야 합니다. - 보안 프리셋 점검: 개인용·기업용 프리셋의 기본값이 정리되었으므로, 기존 설정과 충돌하지 않는지 확인하세요. 명시한 설정과 필수 접근·승인 제한은 그대로 우선합니다.
- 백업 확보: 업데이트 전에 상태 디렉터리와 데이터베이스 백업이 정상인지 확인해 두는 것이 안전합니다.
- 업데이트 후 확인: Doctor 결과, Gateway 시작 상태, 사용 중인 채널(특히 Telegram)과 Cron 작업의 동작을 한 번 점검하세요.