OpenClaw 2026.11.5 업데이트 전체 정리: Changes 4개와 Fixes 36개

제휴 고지: 이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.


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개)

  1. 바쁜 세션 메시지와 보안 프리셋 — 개인 모드에서 세션이 작업 중일 때 보낸 메시지는 호환되는 작업이면 진행 중인 흐름을 조정하고, 아니면 조용히 대기열에 들어갑니다. 더 이상 직접 다시 보낼 필요가 없습니다. 개인용·기업용 보안 프리셋은 서로 일관된 기본값을 제공하되, 사용자가 명시한 설정과 필수 접근·승인 제한은 그대로 적용됩니다. (#185477) 작성: @steipete, 감사: @joshavant.
  2. 컴팩션 — maxSummaryChars 설정으로 컴팩션 요약의 글자 수 상한을 직접 지정할 수 있습니다. (#196207, 관련 #194408) 감사: @aniruddhaadak80, @RomneyDa, @garrytan.
  3. Knowledge — 지식 페이지를 한 번에 읽을 수 있는 크기 안에서 유지하고, 지나치게 큰 페이지 전체를 불러오지 않고도 필요한 섹션만 추출할 수 있습니다. (#186270) 감사: @jalehman.
  4. Breaking: 하네스와 플러그인의 세션 제어 방식 변경 — 서드파티 하네스는 세션 키 기반의 활성 실행을 호스트의 runAttempt 콜백 안에서 등록하고, 반환된 정리(cleanup) 함수를 반드시 보관해야 합니다. 플러그인 RPC 핸들러는 chatAbortControllers와 chatQueuedTurns 대신 권한이 확인된 Gateway 메서드 디스패치를 사용해야 합니다. 시작 소유자 관측값은 expiresAtMs 대신 startDeadlineAtMs를 쓰며, 번들된 소비자는 이미 새 방식으로 옮겨졌습니다. (#175837) 작성: @steipete, 감사: @RomneyDa, @vincentkoc, @jalehman.

Fixes 전체 목록 (36개)

권한·대화·Gateway

  1. Authorization — 대기열에 있던 자동화 실행이 시작되기 전에 소유자 전용 메모리에 대한 접근 권한을 다시 확인합니다. 또한 실패한 하위 작업의 결과는 부모 턴이 끝난 뒤에도 전달될 수 있습니다. (#198697, #197658, 관련 #198695) 감사: @RomneyDa, @daniel-lxs, @obviyus.
  2. Conversation history — 새로 고침을 해도 키가 붙은 코멘터리가 유지되고, 데이터베이스 준비가 동시에 진행되어도 대화 기록 읽기가 끊기지 않으며, 완료됐지만 내용이 빈 시도가 기록을 어지럽히지 않습니다. (#188180, #188055, #188111) 감사: @RomneyDa, @vincentkoc, @fuller-stack-dev, @jalehman.
  3. Gateway recovery — 워크스페이스 준비가 끝난 뒤 중단됐던 턴을 이어서 실행하고, 재시작 의도가 지연되어도 정상 종료 절차를 지키며, 업로드는 워크스페이스 준비 전에 먼저 수신 확인을 보냅니다. (#196423, #188047, #188728) 작성: @steipete, 감사: @RomneyDa, @TameTheGame, @vincentkoc.
  4. Gateway reload — 파일 감시기가 리로드 경쟁에서 먼저 반응해도 설정 업데이트가 멈추지 않으며, 종료가 시작되면 MCP 리스너 작업이 취소됩니다. (#192701, #197119) 감사: @RomneyDa, @zeroaltitude, @obviyus.

Cron과 자동화

  1. Cron scheduling — 예약 작업에 지정한 계정 선택이 유지되고, 재시도 기한과 완료 실행의 식별자가 재시작 후에도 보존됩니다. 스케줄러가 늦게 깨어나도 작업이 조용히 사라지지 않고 처리됩니다. (#180677, #197449, #197484) 감사: @RomneyDa, @vincentkoc, @giodl73-repo, @Stronggenetics, @obviyus.
  2. Cron lifecycle — 설정을 핫 리로드해도 실행 중인 작업이 중단되지 않으며, 시작 기한과 취소 기능이 계속 유효하고, 자동 스케줄링을 끄면 유휴 워커가 해제됩니다. (#197606, #188982, #196387, 관련 #197591) 작성: @steipete, 감사: @vincentkoc, @RomneyDa, @obviyus, @wupingyuan81-oss.
  3. Quiet automations — 조건이 거짓인 트리거 점검은 채팅에 나타나지 않고, 메인 세션 자동화를 DM에서 실행해도 모델 호출 전에 실패하지 않습니다. (#188594, #188700, #180603, 관련 #180602, #197181) 작성: @steipete, 감사: @RomneyDa, @masatohoshino, @obviyus, @Suiah98.

Telegram과 채널

  1. Telegram replies and approvals — 진행 스트림 모드에서 ACP 답장이 다시 표시되고, 승인 요청이 해당 비공개 채팅이나 포럼 토픽 안에 머뭅니다. (#197191, #198038, #192162, 관련 #195899, #197907, #125166) 감사: @bach205, @obviyus, @dankarization, @claxman, @Waste2Time.
  2. Telegram hooks and controls — 전달 훅에 런타임 세션 키를 넘겨주고, 비활성화된 버튼은 눌러도 반응하지 않는 형태로 표시됩니다. (#197519, #191647, 관련 #197186, #197669, #191645) 감사: @lester076, @obviyus, @rodricksz4h5, @tommyjoseph, @aspalagin.
  3. Channels — Feishu에서 블록 스트리밍을 끈 상태에서도 캡션이 붙은 미디어가 전달되고, Matrix와 Mattermost의 디렉터리 검색은 유니코드 정규화 차이를 맞춰 일치시키며, 조작된 Matrix 서식이 멘션 검사를 지연시키지 못하도록 막았습니다. (#191585, #187881, #187199, #184432) 감사: @RomneyDa, @forrystudio, @xialonglee, @obviyus, @wangmiao0668000666, @LeizhenZhang.

음성·UI·데스크톱

  1. iOS voice — 휴대폰이 잠긴 상태에서도 Talk가 계속 동작하고, 음성 인식 권한의 허용 버튼을 눌렀을 때 앱이 종료되던 문제를 고쳤습니다. (#187864, #196822, 관련 #185664) 감사: @RomneyDa, @brianmcguire, @ultrakorne, @obviyus.
  2. Talk startup — 음성 요청이 백엔드 에이전트 시작 전에 멈추지 않으며, 시작 등록에 실패하면 점유하던 자원을 해제합니다. (#183586, #187840, 관련 #187838) 감사: @RomneyDa, @bdjben, @brokemac79, @shakkernerd.
  3. Control UI — 열리는 중인 메뉴를 교체할 때 WebKit이 멈추는 현상을 막고, 채팅 상세 정보가 갱신될 때 이벤트 리스너 오류가 생기지 않도록 했습니다. (#198658, #198380) 감사: @fuller-stack-dev.
  4. Host desktop — 준비 상태 점검 중 VNC 인증을 끝까지 마쳐서, 반복 점검이 서버 잠금을 유발하지 않습니다. (#193487, 관련 #193444) 감사: @SebTardif, @obviyus, @lakemike.
  5. Keyboard and search — 워크트리 선택기에서 IME 탐색이 유지되고, 입력창으로 바로 이동하는 키보드 건너뛰기 기능이 생겼으며, 유니코드상 동일하게 취급되는 첨부 파일 이름도 검색에서 일치합니다. (#187732, #180896, #187674) 감사: @RomneyDa, @ooiuuii, @obviyus, @goutamadwant, @LiuwqGit, @huwei-xydt.
  6. UI responsiveness — 세션을 반복해서 전환할 때 WebKit이 점점 느려지는 문제를 줄이고, 정적 로딩 애니메이션 자원을 해제하며, 중단된 data-URL 미리보기를 정상 상태로 마무리합니다. (#194027, #194146, #191451) 작성: @steipete, 감사: @RomneyDa, @vincentkoc, @wangjx-xydt.

모델·공급자

  1. Provider continuity — 인증 소스나 모델을 바꿔도 공급자 체크포인트가 계속 사용 가능한 상태로 남습니다. (#200063, #200208) 감사: @obviyus.
  2. OpenAI and Anthropic — 훅이 요청을 덮어써도 저장된 컨텍스트 재생이 유지되고, 완료 웨이크와 메시지 경로가 바뀌어도 Anthropic 세션 프롬프트가 안정적으로 유지됩니다. (#199451, #197835, #197925) 감사: @RomneyDa, @vincentkoc, @vyctorbrzezowski, @obviyus.
  3. Claude CLI and providers — 라이브 세션 정리에 실패한 뒤에도 복구되고, 로컬 전송 장애가 정리된 뒤 다시 연결하며, Anthropic 모델을 고정하지 않아도 Claude CLI 모델이 목록에 포함됩니다. (#198224, #187375, #191148, 관련 #195431, #187023) 감사: @obviyus, @mdarapour, @wtfichigo, @etzelm, @Takhoffman.
  4. Model discovery — 모델 설정이 매우 클 때 읽기가 느려지는 문제를 피하고, SDK를 동시에 가져오는 상황에서도 공급자 탐색이 복구됩니다. (#198837, #196448, 관련 #195477) 감사: @RomneyDa, @vincentkoc, @1052326311, @WG-Mojo.
  5. Provider routing — OpenRouter 요청이 자체 엔드포인트에 머물고, 설정을 저장할 때 모델이 몰래 API 키 과금 방식으로 바뀌지 않습니다. (#185294, #191326, 관련 #185272) 감사: @vishnusenthil-16, @obviyus, @etzelm.
  6. Rate limits — 도구 실행 이후 설정된 최대 재시도 지연 시간을 지켜서, 지나치게 긴 대기로 세션 레인을 붙잡고 있지 않습니다. (#197611, 관련 #168101) 작성: @steipete, 감사: @kringsc.

Doctor·업데이트·백업

  1. Doctor and upgrades — Doctor 시작 시 대기 시간에 상한을 두고, SIGTERM을 존중하며, 호스팅 환경 점검이 라이브 세션을 멈추게 하지 않습니다. (#187936, #191125) 작성: @steipete, 감사: @RomneyDa, @vincentkoc.
  2. Update reliability — Doctor가 진행 상황을 확인하는 동안에도 데이터베이스 복원 기능을 유지하고, 무해한 빈 WAL 전환을 허용하며, 실패한 플러그인 후 Doctor 경고를 보존하고, 업데이트 후 점검 전에 Gateway가 정상 시작됐는지를 인식합니다. (#192083, #193134, #192942) 작성: @steipete, 감사: @TameTheGame, @RomneyDa, @vincentkoc, @fuller-stack-dev.
  3. macOS onboarding — 설치 프로그램의 터미널 인계 상태를 유지하여, 온보딩 중 플러그인을 설치할 때 분리된 npm 터미널 때문에 실패하지 않습니다. (#200247, 관련 #200244) 감사: @RomneyDa, @vincentkoc, @miguelbranco80.
  4. Stored state — 이름이 바뀐 에이전트의 콜드 대화 기록을 복구 전에 되살리고, 삭제된 에이전트의 보존 데이터베이스가 남아 있어도 문제없이 처리하며, 보류 중인 데이터베이스는 명시적으로 복원하기 전까지 분리해 둡니다. (#196079, #198145, #198180, 관련 #196066) 작성: @steipete.
  5. Backups — 스냅샷 압축을 스테이징 디렉터리 안에서 수행하고, 실제 데이터베이스를 복사하지 않고 백업 엔진을 점검하며, SQLite 손상 진단 정보를 보존합니다. (#194230, #194234, #194497, 관련 #194208, #194209) 작성: @steipete, 감사: @GoatInAHat.
  6. Backup diagnostics — 백업 수집 중 사용 중인 파일을 식별해 알려주고, 일시적인 Windows 접근 실패는 무결성 검사를 약화하지 않으면서 재시도합니다. (#193685) 작성: @steipete, 감사: @wr-web.
  7. Update recovery — 상태 경로 별칭, 라이브 정리 중 쓰기, 환경 변수로만 지정한 서비스 오버라이드가 있어도 복원 진행 상황을 잃지 않습니다. (#189004, #189628, #196371) 작성: @steipete, 감사: @RomneyDa.
  8. Update cleanup — 남아 있는 스냅샷 사본이나 NFS 스냅샷 디렉터리 정리 때문에 생기던 잘못된 실패 판정을 없애고, 리허설 중에도 외부 플러그인 데이터를 보존합니다. (#193702, #195409, #196301, 관련 #195396) 감사: @RomneyDa, @fuller-stack-dev, @tianping.

저장소·메모리·패키지

  1. Cold storage and startup — 대용량 대화 인덱스를 복구할 때 워커 메모리 부족으로 실패하던 문제를 피하고, 유휴 리더가 닫힌 뒤에도 콜드 PostgreSQL 대화를 복원하며, Gateway 시작 중 데이터베이스 복제가 멈추는 현상을 막습니다. (#194099, #189991, #190918) 작성: @steipete, 감사: @TameTheGame, @RomneyDa, @vincentkoc, @etzelm, @Frosmans.
  2. Memory and SQLite — Dreaming이 같은 목록을 중복해서 읽지 않게 하고, 완료된 SQLite 리더를 해제하며, 커서가 처음부터 다시 시작되는 문제를 막습니다. (#180692, #190242, 관련 #180657) 감사: @chelsealong, @obviyus, @lisandromachado, @ava-perry.
  3. Plugin rebuilds — 플러그인을 다시 빌드할 때마다 Gateway 메모리가 불어나지 않도록, 더 이상 쓰지 않는 플러그인 세대의 상태를 해제합니다. (#199042) 감사: @etzelm, @Patrick-Erichsen.
  4. Packages and discovery — PostgreSQL 타입 선언을 패키지에 포함하고, 패키지된 플러그인 export가 컴파일된 런타임 파일을 가리키게 하며, npm 설치 환경에서 Bonjour 탐색을 복원합니다. (#188091, #188639, #199156) 작성: @steipete, 감사: @RomneyDa, @vincentkoc, @galiniliev, @alfredjbclaw.
  5. Browser and workflow paths — 네이티브 CORS preflight 요청을 그대로 보존하고, Lightpanda 탐색 시간 초과를 피하며, 워크플로 경로에 포함된 공백을 잘라내지 않고 문자 그대로 유지합니다. (#185028, #196400, #187785) 작성: @steipete, 감사: @vincentkoc, @RomneyDa, @eleqtrizit, @wangmiao0668000666, @obviyus.
  6. 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 작업의 동작을 한 번 점검하세요.

changelog 원문