변경 이력 확인법
기준일: 2026-07-26
난이도: 초급
공식 기준: Release notes, v2026.7.1, v2026.6.11, GitHub releases, Update CLI
OpenClaw release 정보는 빠르게 바뀝니다. 아래 고신호 요약은 가이드에 마지막으로 반영한 npm latest 기준 버전(2026.7.1-2) 과 그 이전 가이드 반영분(2026.5.18) 사이의 사용자 영향 항목입니다. 세부 패치·beta 항목은 공식 원문을 확인하세요.
가이드 반영 버전
| 항목 | 값 |
|---|---|
| 가이드 반영 npm 버전 | 2026.7.1-2 (latest dist-tag, 2026-07-18 게시) |
| 이전 가이드 반영 | 2026.5.18 (2026-05-21) |
| curated release notes | v2026.7.1 (2026-07-13), v2026.6.11 (2026-06-30) |
| 설치 확인 | openclaw --version, openclaw update status |
npm
extended-stable·beta태그는latest와 다를 수 있습니다. 문서의 특정 날짜 스냅샷을 “영구 최신”으로 단정하지 마세요.
2026.5.18 → 2026.7.1-2 고신호 변경
1. 채널·iMessage (필수 마이그레이션)
| 변경 | 버전/출처 | 영향 |
|---|---|---|
| BlueBubbles 제거 | 공지 | channels.bluebubbles는 무시됨. 신규·이전 모두 channels.imessage + imsg |
| 설정 키 변환표 | Coming from BlueBubbles | serverUrl/password 폐기, allowFrom·groups 등은 의미 유지, group key는 chat_id |
| 확장 채널 | channels index | ClickClack, Nextcloud Talk, Nostr, QQ Bot, Raft, Reef, SMS, Synology Chat, Tlon, WeChat, Yuanbao, Zalo personal/ClawBot 등 |
| Raft wake bridge | v2026.6.11 | Raft External Agent CLI wake 경로 |
| Slack router relay | v2026.6.11 | 중앙 router로 mention/thread를 올바른 Gateway에 전달 |
| Telegram/Slack/Discord/iMessage 배달 신뢰성 | v2026.6.11, v2026.7.1 | 중복·오라우팅·progress·미디어 앨범 등 대량 수정 |
로컬 가이드: BlueBubbles 이전, iMessage, 확장 채널 요약.
2. Control UI·온보딩·공식 앱 (v2026.7.1)
- Control UI: 세션 핀/그룹/분할 페인, live Tasks 페이지, Usage(비용·쿼터·플랜), Workboard, worktrees 설정 이동
- Onboarding: fresh install → guided setup, 구성된 설치 → TUI, Crestodian 대화형 설정 옵션
openclaw doctor/ update: 읽기 불가한openclaw.json덮어쓰기 거부openclaw update --channel extended-stable유지·검사- 공식 iOS / Android / macOS 앱: 오프라인 캐시 세션, 전송 큐, Watch 음성(iOS) 등
- macOS: Terminal 없이 로컬 에이전트 첫 실행 경로 강화
3. 모델·코딩 에이전트 연동 (v2026.7.1)
- GPT-5.6 (Sol/Terra/Luna 등 지원 경로), Claude Sonnet 5 / Mythos 5, Tencent Hy3, Meta Muse Spark 1.1, LongCat-2.0
openclaw promos list|claim— 프로모 모델 클레임openclaw attach— Claude Code에 세션 범위 Gateway MCP grant (임시·회수 가능)- Codex app-server / supervision: native child-agent → task 기록
- 활성
/goal이 compaction·큐·중단 후에도 유지
4. 자동화·CLI 표면
| 표면 | 설명 | 공식 |
|---|---|---|
openclaw tasks / tasks flow |
background task 원장 + Task Flow | tasks, Task Flow |
| Standing orders | workspace(AGENTS.md 등) 상시 운영 권한 |
Standing orders |
openclaw infer |
모델/이미지/오디오/TTS/비디오/웹/임베딩 허브 | infer |
openclaw commitments |
추론된 follow-up 조회·dismiss | commitments |
openclaw transcripts |
저장 transcript list/show/export | transcripts |
openclaw wiki |
memory-wiki vault | wiki |
openclaw path |
oc:// workspace 파일 주소 |
path |
openclaw policy |
정책 적합성 검사 | policy |
openclaw workboard |
카드·dispatch (플러그인) | workboard |
openclaw fleet |
테넌트 cell 프로비저닝 | fleet |
openclaw flows |
리다이렉트 → openclaw tasks flow |
flows redirect |
로컬 가이드: CLI 명령어, Task Flow와 Hooks, 자동화 개요.
5. 메모리·개념
- Dreaming (light / deep / REM) +
DREAMS.md검토 흐름 - Active Memory 플러그인: 대화 세션에 관련 메모리 주입 (active-memory)
- Managed worktrees: 격리 git checkout (managed-worktrees)
- memory-wiki /
openclaw wiki복원·확장
6. 설치·마이그레이션·호스팅
- Migrating from Claude, Migrating from Hermes
- 클라우드/호스트 경로 확대: Azure, DigitalOcean, Fly, GCP, Hetzner, Hostinger, K8s, Northflank, Railway, Render, Upstash Box, Raspberry Pi 등 (Install)
- Docker Hub
openclaw/openclaw미러 (v2026.6.11 계열 노트) - Bun 런타임으로 SQLite state를 여는 경로 차단, Node(WAL-safe) 유도 (v2026.7.1)
7. 신뢰성·보안 (v2026.6.11 중심)
- 채널 배달·세션 연속성·provider fallback·plugin 수리 대량 수정
- DOMPurify 패치 등 Control UI 의존성 보안
- plugin policy hook이 reload 후에도 유지
- Matrix E2EE recovery / 메모리 누수 완화
핵심 개념 (업데이트 절차)
- 문서의 Release notes는 사용자 영향과 주요 변경을 설명합니다.
- GitHub releases와
CHANGELOG.md는 더 촘촘한 maintainer 기록을 제공합니다. openclaw --version과openclaw update status가 현재 설치 상태의 기준입니다.- 이 페이지의 버전 표는 가이드 동기화용이며, 설치본의 단일 진실 소스가 아닙니다.
선택 기준
| 목적 | 확인 방법 |
|---|---|
| 설치 버전 확인 | openclaw --version |
| 업데이트 가능 여부 | openclaw update status |
| 사용자 영향 파악 | 공식 Release notes |
| 모든 변경 항목 추적 | GitHub releases와 CHANGELOG.md |
| 업그레이드 후 진단 | doctor --post-upgrade, status --all |
실습
업데이트 전에 현재 상태와 백업을 확보합니다.
openclaw --version
openclaw update status
openclaw config validate
openclaw backup create --verify
공식 release notes에서 다음 항목을 우선 확인합니다.
- channel delivery와 session routing (특히 BlueBubbles → iMessage)
- provider 인증과 model fallback
- Gateway 보안 기본값과 원격 접근
- plugin 호환성과 install policy
- config migration 또는 제거·리다이렉트된 명령 (
flows→tasks flow)
업데이트 후:
openclaw doctor --post-upgrade --json
openclaw status --all
openclaw channels status --probe
BlueBubbles 잔여 설정이 있으면:
# channels.bluebubbles 블록이 남아 있는지 설정 파일을 확인한 뒤
# Coming from BlueBubbles 변환표로 channels.imessage로 옮긴다.
openclaw channels status --probe --channel imessage
도구에 입력할 프롬프트
현재 openclaw --version부터 목표 버전까지 공식 release notes와
GitHub releases를 대조해줘. 우리 설정에 영향을 주는 channel,
provider/model, Gateway security, plugin, config 변경만 추려줘.
출처가 없는 호환성 판단은 추정이라고 표시해줘.
체크리스트
- 현재 버전과 update status를 확인했다.
- 공식 release 원문을 읽었다 (최소 v2026.6.11, v2026.7.1).
- 변경 전 검증된 backup을 만들었다.
- BlueBubbles 사용 시
channels.imessage이전을 완료했다. - 업그레이드 후 doctor와 channel probe를 실행했다.
- 문서의 기준 버전을 최신 버전으로 단정하지 않았다.
다음 단계
- CLI 명령어 참조에서 진단·백업·신규 명령 표면을 확인합니다.
- BlueBubbles에서 iMessage로 이전에서 iMessage 컷오버를 진행합니다.
- 트러블슈팅에서 업데이트 후 오류를 분리합니다.