문서 변경 이력
OpenClaw 한국어 가이드 업데이트 내역입니다.
Unreleased (예정)
추가 예정
- 서브 에이전트 심화 문서
- 실전 사용 사례 모음
- 비디오 튜토리얼
- 성능 최적화 가이드
Version 2026.5.18 (2026-05-18)
2026.5.12 이후 stable 롤업 릴리즈 (2026.5.14, 2026.5.17 beta 트레인 포함).
변경사항
- Dependencies: 번들 Pi 패키지를
0.75.1로 갱신하고 지원 최소 Node.js 22 라인을22.19로 상향. - Docker/Podman: 추가 apt 패키지 지정용 런타임 중립 이미지 빌드 인자
OPENCLAW_IMAGE_APT_PACKAGES추가 (OPENCLAW_DOCKER_APT_PACKAGES는 레거시 폴백으로 유지). (#62431) - Plugins/SDK: 타입화된 단순 tool 플러그인을 위한
defineToolPlugin및openclaw plugins build/validate/init명령 추가 (매니페스트 메타데이터, 선택적 tool 선언, context factory 자동 생성). - Skills: meme-maker(밈 템플릿 검색/렌더링), node inspector debugging, Python debugging(pdb/breakpoint/debugpy), fused diagram generation 등 신규 스킬 추가. Obsidian 스킬은 공식
obsidianCLI를 사용하도록 변경. - Android: Talk Mode를 실시간 Gateway relay voice 세션(스트리밍 마이크 입력, 실시간 오디오 재생, 화면 내 transcript)으로 전환. (#83130)
- Proxy: HTTPS managed forward-proxy 엔드포인트 및 proxy 엔드포인트 TLS용
proxy.tls.caFileCA 신뢰 지원. (#79171) - Browser: 스냅샷에서 모달 다이얼로그 표시, 모달 발생 시
blockedByDialog반환,browser dialog --dialog-id로 응답 가능.
버그 수정
- Media: Sharp를 루트 패키지로 설치하고, 미사용 시 sips/Windows 네이티브 이미징/ImageMagick/GraphicsMagick/ffmpeg로 폴백. (#83401)
- Telegram: requester-agent 핸드오프 간 topic ID 보존으로 생성된 미디어를 포럼 토픽으로 전달. (#83556)
- Telegram:
/btw및 읽기 전용 status 명령이 활성 run을 중단시키지 않도록 수정. - Gateway: update-check 시작을 readiness 이후로 연기해 패키지 업데이트 확인이 sidecar-ready 시작을 막지 않도록 수정. (#83520)
- Messages: 그룹/채널 visible reply 기본값을 자동 final 전달로 복원, ambient/공유 룸은
message_toolopt-in 유지. - OpenAI/Codex: config 검증 시 사용 가능한
openai-codexGPT-5.1/5.2/5.3 모델 ref를 거부하지 않도록 수정 (제거된 Spark alias는 계속 억제). (#83303) - Plugins: 레거시
before_agent_start훅에 기본 15초 타임아웃 적용으로 멈춘 핸들러가 에이전트 시작을 막지 않도록 수정. (#48534)
Version 2026.5.12 (2026-05-14)
변경사항
- 경량 설치: WhatsApp, Slack, Amazon Bedrock, Amazon Bedrock Mantle, Anthropic Vertex, OpenShell sandbox provider/플러그인 의존성을 코어에서 분리해 설치 시 사용하는 것만 가져오도록 externalize.
- Control UI/WebChat: 영구 저장되는 auto-scroll 모드 선택기 추가 (near-bottom 유지 / 스트리밍 출력 항상 따라가기 / 자동 스크롤 끄고 New messages 버튼 수동 사용). (#7648, #81287)
- ACP: 기본 백엔드 불가 시 구성된 백업 런타임 백엔드를 시도하는
acp.fallbacks추가. (#69542) - Plugins/install: pnpm 11 지원.
버그 수정
- Telegram: 메인 이벤트 루프 정체 중에도 Bot API 폴링을 유지하도록 ingress를 격리 워커 + 영구 로컬 spool로 이전. (#81132)
- Telegram: lazy cron announce 전달 시 렌더된 HTML 포맷을 보존해 Markdown 링크가 리터럴 anchor 태그로 떨어지지 않도록 수정. (#81742)
- Telegram:
requireMention활성 시 미언급 그룹 미디어를 다운로드 전에 건너뛰어 무시할 메시지의 미디어 다운로드 실패를 방지. (#81181) - Gateway protocol: v4 클라이언트를 요구하고 명시적 chat
deltaText/replace프레임을 스트리밍해 SDK 클라이언트가 로컬 diff 없이 assistant 업데이트를 소비하도록 변경. (#80725) - Models config/auth: 광범위한
^[A-Z_][A-Z0-9_]*$문자열에서 provider 환경변수 마커를 추론하지 않고, config의apiKey는 구조화된 env SecretRef(secrets.providers[id]/secrets.defaults)로만 해석해 무관한 환경변수가 자격증명이 되지 않도록 수정. - Replies: rich presentation/interactive controls/채널 네이티브 payload를 follow-up, heartbeat, cron, ACP, block-streaming 경로 전반에서 outbound 콘텐츠로 취급해 card/button-only 응답이 빈 응답으로 폐기되지 않도록 수정.
보안 수정
- Security/sandbox: Windows
USERPROFILE를 sandbox 차단 home root에 포함해HOME이 다른 곳을 가리켜도.codex/.openclaw/.ssh바인드를 거부. (#63074) - Session transcripts: 중앙 JSONL append 경로에서 민감 메시지 내용을 redact해 CLI/gateway/mirror/tool 결과가 동일한 redaction 동작을 사용하도록 수정. (#73565)
Version 2026.5.7 (2026-05-07)
변경사항
- OpenAI: 안정 기본 모델 변경 없이 ChatGPT Instant API alias를 시험할 수 있는 직접 API-key 모델 override
openai/chat-latest지원. - Cron CLI:
cron list --json/cron show --json출력에 계산된status포함 (disabled/running/ok/error/skipped/idle). (#78701) - Channels CLI:
openclaw channels list를 채널 전용으로 변경, 번들/카탈로그 채널용--all추가, 모델 auth/usage 정보는openclaw models auth list/openclaw status/openclaw models list로 이전. (#78456)
버그 수정
- Doctor/Codex OAuth:
doctor --fix시 동작하는openai-codex/*PI 경로를 보존하고, Codex OAuth 인증만 가능할 때 2026.5.5에서openai/*로 재작성된 GPT-5 경로를 복구해 구독 인증 설정이 깨지지 않도록 수정. (#78407) - Discord/message:
discord:channel:<id>형식 provider-prefix 타깃을 레거시 DM이 아닌 채널 전송으로 파싱해message(action="send")채널 ID 오라우팅을 방지. (#78572) - Agents/compaction: compaction 요약 reserve 토큰을 각 모델의 출력 한도로 clamp해 잘못된
max_tokens요청을 방지. (#54392) - Codex/approvals: Codex approval 모드에서 안전한 명령을 Codex reviewer가 먼저 승인하도록 pre-guardian 네이티브
PermissionRequest훅 기본 설치를 중단, 동일 payload의allow-always결정을 세션 윈도우 내에서 기억. - Telegram:
accessGroup:*발신자 allowlist를 DM/그룹/네이티브 명령/콜백 권한 검사에서 Telegram 숫자 ID 검사보다 먼저 적용. (#78660)
Version 2026.5.6 (2026-05-06)
버그 수정
- Doctor/OpenAI Codex: 유효한
openai-codex/*ChatGPT/Codex OAuth 경로를openai/*로 재작성하던 2026.5.5doctor --fix동작을 되돌림 (OAuth 전용 GPT-5.5 설정이 깨지거나 OpenAI API-key 경로로 옮겨지는 문제). 2026.5.5에서 기본 모델이 바뀐 경우openclaw models set openai-codex/gpt-5.5 && openclaw config validate로 Codex OAuth PI 경로로 복원. (#78407) - Plugins/runtime fetch: 네이티브
fetch/Headers에 넘기기 전 일반 요청 헤더 사전에서 서드파티 symbol 메타데이터를 제거해 유효한 플러그인 요청이 거부되지 않도록 수정. (#77846) - Web fetch: 요청 타임아웃 후 guarded dispatcher 정리를 bound 처리해 타임아웃된 fetch가 Gateway tool 레인을 계속 점유하지 않도록 수정. (#78439)
Version 2026.5.5 (2026-05-06)
버그 수정
- Doctor/Codex: 주 모델, fallback, heartbeat/subagent/compaction override, 훅, 채널 override, 오래된 세션 pin의 레거시
openai-codex/*경로를 canonicalopenai/*로 복구하고, Codex 플러그인이 설치/활성화·codexharness 제공·사용 가능한 OAuth가 있을 때만agentRuntime.id: "codex"를 선택(아니면pi). - Providers/xAI: 네이티브 Grok Responses 모델에 OpenAI식 reasoning effort 컨트롤 전송을 중단하고 번들 xAI thinking 프로필을
off로 clamp해xai/grok-4.3라이브 실행 실패(Invalid reasoning effort)를 수정. - Providers/Fireworks: Kimi 모델을 thinking-off 전용으로 노출하고 K2.5/K2.6 요청을
thinking: disabled로 유지해 수동 모델 전환 시 Fireworks가 거부하는reasoning*파라미터 전송을 방지. - Telegram/Codex: message-tool-only progress draft 가시성 유지, 네이티브 Codex tool progress를 tool당 1회만 렌더링해 중복 draft 라인을 방지. (#75641)
- Docker/Gateway: 번들
docker-compose.yml에서NET_RAW/NET_ADMINcapability를 제거하고no-new-privileges를 활성화해 게이트웨이 컨테이너를 강화. - Status:
/status에 Gateway 프로세스 uptime과 호스트 시스템 uptime을 표시.
Version 2026.5.4 (2026-05-05)
변경사항
- Google Meet/Voice Call: Twilio dial-in 참가를 실시간 Gemini voice bridge로 발화하도록 변경 (페이스드 오디오 스트리밍, backpressure 인지 버퍼링, barge-in 큐 정리). (#77064)
- OpenAI/Codex media: Codex 오디오 transcription을 런타임/매니페스트 메타데이터에 광고하고 활성 Codex chat 모델을 OpenAI transcription 기본값으로 라우팅.
- Models/auth: 시크릿 노출 없이 저장된 per-agent auth 프로필을 확인하는
openclaw models auth list [--provider <id>] [--json]추가. - Slack/streaming: 구조화된 progress line 데이터 기반 Block Kit progress draft용
streaming.progress.render: "rich"추가. - Agents/verbose:
/verbose및 progress draft에 compact explain-mode tool 요약을 기본 적용, 디버깅용agents.defaults.toolProgressDetail: "raw"및 per-agent override 제공. - Exec approvals: 향후 승인/명령 검토 표면을 위한 tree-sitter 기반 셸 명령 explainer 추가. (#75004)
버그 수정
- Gateway/startup: 명시적으로 구성된 image/video/music 생성 기본값을 소유한 provider 플러그인을 로드해 생성 tool이 게이트웨이 재시작 후 catalog-only로 남지 않도록 수정. (#77244)
- Agents/cache: per-turn 런타임 컨텍스트를 일반 chat system prompt에서 제외하되 hidden 현재-turn 컨텍스트는 전달해 chat 연속 시 prompt-cache 재사용을 복원. (#77431)
- Agents/Tools: auto-compaction-retry 이후 무장하는 post-compaction loop guard를 추가해 동일
(tool, args, result)가windowSize(기본 3)회 반복되면compaction_loop_persisted로 run을 중단 (tools.loopDetection으로 비활성/튜닝). (#77474) - Agents/OpenAI: 직접 OpenAI Responses 모델을 WebSocket 자동 선택 대신 SSE 전송 기본으로 변경해 WebSocket 경로가 멈추는 서버에서 pi 런타임 chat turn 행을 방지.
- Plugins/providers: 신규 config에 대해 번들 provider discovery가 기본적으로 제한적
plugins.allow를 따르도록 하고, 레거시 제한 allowlist 설정은 doctor가plugins.bundledDiscovery: "compat"로 마이그레이션. - Docker/compose: 컨테이너 측
OPENCLAW_CONFIG_DIR/OPENCLAW_WORKSPACE_DIR를 고정해 호스트 경로가 런타임 코드로 새어 들어가는 macOS Docker 설정 회귀(EACCES ... mkdir '/Users')를 수정. (#77436)
Version 2026.5.3-1 (2026-05-04)
v2026.5.3의 코어 npm 핫픽스 릴리즈 (beta dist-tag로 게시된 openclaw@2026.5.3-1).
버그 수정
- Plugins/security: 동일 컴파일 번들의 멀리 떨어진 부분에서만
process.env접근과 일반 API 전송이 나타날 때 install scanner가 공식 번들 플러그인 패키지를 차단하지 않도록 수정.
Version 2026.5.3 (2026-05-04)
변경사항
- Plugins/file-transfer: paired node의 바이너리 파일 작업을 위한
file_fetch/dir_list/dir_fetch/file_write에이전트 tool을 갖춘 번들 file-transfer 플러그인 추가.plugins.entries.file-transfer.config.nodes하의 기본 거부 per-node 경로 정책 + operator 승인, 기본 symlink traversal 거부(opt-infollowSymlinks), 왕복당 16MB 상한. (#74742) - Channels/streaming: Discord/Telegram/Matrix/Slack/Microsoft Teams 전반에 자동 단어 status 라벨과 공유 progress 설정을 가진 통합
streaming.mode: "progress"draft 추가. - Agents/commands: 새 turn 시작 없이 활성 현재-세션 run을 큐와 독립적으로 steer하는
/steer <message>추가. (#76934) - Tools/BTW:
/btwside question의 텍스트 및 네이티브 슬래시 명령 alias로/side추가. - Gateway/config: 게이트웨이 시작/hot reload가 잘못된 config를 자동 복원하지 않도록 변경 (fail-closed, last-known-good 복구는
openclaw doctor --fix가 담당). - Channels/WhatsApp: DM 라우팅 대신 채널 세션 메타데이터로 명시적 WhatsApp Channel/Newsletter
@newsletteroutbound 타깃 지원. (#13417)
버그 수정
- Channels/WhatsApp:
@whiskeysockets/libsignal-node를onlyBuiltDependencies에 허용해 pnpm v9+blockExoticSubdeps가 baileys git-tarball subdep를 거부하며 모든 인바운드 응답을 막던 문제를 수정. (#76539) - Config/messages: boolean
messages.visibleReplies/messages.groupChat.visibleReplies값을 문서화된 enum 모드로 강제 변환해 직관적 토글이 config를 무효화하지 않도록 수정. (#75390) - Agents/tools:
tools.deny: ["write"]를 암묵적apply_patchdeny로 취급하지 않도록 변경 (패치 쓰기 차단은apply_patch또는group:fs를 명시적으로 deny). (#76749) - Plugins/Anthropic·OpenCode·OpenRouter: Claude/DeepSeek V4 thinking 프로필(
xhigh/adaptive/max)을 lightweight provider policy 표면으로 노출해/think검증이 거부하지 않도록 수정. (#76779, #76648, #74788) - Telegram: top-level 및 account별
channels.telegram.mediaGroupFlushMs추가로 하드코딩된 500ms 앨범 버퍼링 윈도우를 튜닝 가능하게 변경. (#76149)
Version 2026.5.2 (2026-05-02)
변경사항
- Plugins/beta: 무거운 런타임 스택을 코어에서 분리하기 위해 ACPX를
@openclaw/acpx로, diagnostics OpenTelemetry를@openclaw/diagnostics-otel로 externalize. Google Chat, LINE, Matrix, Mattermost, BlueBubbles, Google Meet, Discord, Memory LanceDB, Microsoft Teams, QQ Bot, Voice Call, WhatsApp, Brave, Codex, Feishu 등을 npm/ClawHub 게시용으로 준비. - Providers/xAI: Grok 4.3을 번들 카탈로그에 추가하고 기본 xAI chat 모델로 지정.
- Gateway/startup·restart: 시작 secrets preflight 중 플러그인 기반 auth-profile overlay를 건너뛰어 readiness 지연 감소,
openclaw gateway restart --force및--wait <duration>추가. (#68327) - Channels/thread bindings: 분리된 subagent/ACP thread-spawn 토글을
threadBindings.spawnSessions로 대체하고 thread-bound spawn을 기본 활성, 레거시 키는openclaw doctor --fix가 마이그레이션. (#75943) - Plugins/CLI: ref checkout/커밋 메타데이터/scanner·staging과
plugins update를 지원하는 일급git:플러그인 설치 추가. - Heartbeats/agents: tool-capable heartbeat run에서 quiet 결과 또는 명시적 알림 텍스트를 기록하는 구조화된
heartbeat_respondtool 추가 (HEARTBEAT_OK파싱 의존 완화). (#75765)
버그 수정
- Agents/OpenAI: GPT-5 API-key 세션을 명시적 WebSocket 선택이 없으면 SSE Responses 전송으로 기본 처리해 신규 Control UI/WebChat beta 설치에서 응답이 없던 문제를 복구.
- Sessions/transcripts: 세션 transcript 락 획득에 단일
session.writeLock.acquireTimeoutMs정책을 적용하고 기본 대기를 60초로 상향해 정상적인 느린 prep/cleanup/compaction 중 사용자 가시 락 타임아웃을 방지. (#75894) - Gateway/CLI/status:
openclaw gateway start가 시작 전 오래된 managed 서비스 정의(구버전 OpenClaw·누락 바이너리·임시 installer 경로)를 복구하고, 큰 런타임 config가 reply 시작을 막지 않도록 plugin tool descriptor config hashing 반복을 회피. (#75944) - Telegram/native commands: topic-bound 세션의 plugin command에 영구 세션 파일을 전달해 Telegram 포럼 토픽에서
/codex bind가 동작하도록 수정. - Discord: 게이트웨이 재시작 간 활성 button/select/form을 만료 전까지 유지해 multi-step 상호작용이 업그레이드/재시작 중 깨질 가능성을 줄임.
Version 2026.4.29 (2026-04-30)
변경사항
- Agents/commitments: opt-in 추론형 follow-up commitment 추가 (hidden 배치 추출, per-agent/per-channel 스코핑, heartbeat 전달, CLI 관리,
commitments.enabled/commitments.maxPerDay설정). (#74189) - Messages/queue: 활성 run 큐잉 기본값을
steer(다음 모델 경계에서 대기 중인 모든 steering 메시지 drain)로 변경하고 레거시 1건씩 처리를queue로 유지, 500ms followup fallback debounce 추가. - Messages: 모든 source chat에서 visible 출력을
message(action=send)로 보내도록 요구할 수 있는 전역messages.visibleReplies추가 (messages.groupChat.visibleReplies는 그룹/채널 override로 유지). - Memory/wiki: agent용 people wiki 메타데이터(canonical alias, person card, relationship graph, privacy/provenance 보고, 검색 모드) 추가.
- Active Memory: 선택된 대화만 recall을 활성화하는 per-conversation
allowedChatIds/deniedChatIds필터 추가, 서브 에이전트 타임아웃 시 bounded 부분 recall 요약 반환. (#67977, #73219) - Providers/NVIDIA: API-key 온보딩/설정 문서/정적 카탈로그 메타데이터를 갖춘 NVIDIA provider 추가. (#71204)
- Plugins: 재시작 안전 keyed 레지스트리(TTL/eviction/플러그인 격리)를 위한 SQLite 기반 플러그인 상태 저장소
api.runtime.state.openKeyedStore추가. - Docker setup: 자동 Docker 설치에서 대화형 온보딩을 건너뛰는
OPENCLAW_SKIP_ONBOARDING추가. (#55518)
버그 수정
- Providers/Amazon Bedrock: Bedrock 모델 ref에 전체 Claude Opus 4.7 thinking 프로필(
xhigh/adaptive/max)을 노출하고 Opus/Sonnet 4.6은 adaptive 기본을 유지해/think메뉴/검증을 Anthropic 전송과 일치시킴. (#74701) - Web fetch: 신뢰된 fake-IP proxy 스택(
fc00::/7)을 위한tools.web.fetch.ssrfPolicy.allowIpv6UniqueLocalRangeopt-in 추가. (#74351) - Slack/interactive replies: 렌더된 button/select와 fallback 텍스트를 Slack Block Kit 값/개수/길이 한도 내로 제한해 과도한 agent 작성 선택지가 전체 block payload를 거부당하지 않도록 수정.
- Channels/WhatsApp: Baileys outbound 메시지 ID가 있어야 auto-reply를 delivered로 표시해 실패한 그룹 응답이 전송된 것처럼 보이지 않도록 수정. (#49225)
- Channels/Discord: 시작 application 조회 및 gateway 메타데이터 fetch 중 Cloudflare/Error 1015 HTML 429 실패에 cooldown 적용, app-id 조회 우회용
channels.discord.applicationId추가. (#38853)
보안 수정
- Security/tools: 구성된 tool 섹션(
tools.exec,tools.fs)이 제한 프로필(messaging,minimal)을 암묵적으로 넓히지 않도록 변경. 제한 프로필에서 해당 tool이 필요하면 명시적alsoAllow항목을 추가해야 하며 시작 경고가 영향받는 config를 식별. (#47487) - Security/OpenGrep: precise OpenGrep rulepack, source-rule 컴파일러, provenance 메타데이터 검사, SARIF를 GitHub Code Scanning에 업로드하는 PR/full scan workflow 추가. (#69483)
Version 2026.4.27 (2026-04-29)
변경사항
- Codex: Codex-mode 에이전트용 Computer Use 설정 추가 (
/codex computer-use status/install, marketplace discovery, 선택적 자동 설치, Codex-mode turn 시작 전 fail-closed MCP 서버 검사). (#72094) - Providers/DeepInfra:
DEEPINFRA_API_KEY온보딩, 동적 OpenAI 호환 모델 discovery, 이미지 생성/편집, 이미지/오디오 미디어 이해, TTS, text-to-video, 메모리 임베딩을 갖춘 번들 DeepInfra provider 추가. - Security/networking: opt-in operator 관리 outbound proxy 라우팅(
proxy.enabled+proxy.proxyUrl/OPENCLAW_PROXY_URL) 추가 (엄격한http://forward-proxy 검증, loopback-only Gateway 우회). (#70044) - Channels/Yuanbao: Tencent Yuanbao 외부 채널 플러그인(
openclaw-plugin-yuanbao)을 공식 채널 카탈로그에 등록, WebSocket 봇 DM/그룹 채팅용 quick-start 가이드 추가. (#72756) - Channels/QQBot: 전체 그룹 채팅 지원(히스토리 추적, @-mention gating, activation 모드, per-group config, FIFO 메시지 큐), C2C
stream_messages스트리밍, 대용량 청크 업로드 통합sendMedia추가. (#70624) - Sandbox/Docker: 호스트 Docker 런타임이
--gpus를 지원할 때 sandboxed 에이전트 내부에서 로컬 GPU 워크로드를 실행하는 opt-insandbox.docker.gpuspassthrough 추가. (#57976)
버그 수정
- Gateway/startup: 채널을 primary 모델 prewarm 대기 없이 시작하고 모델 warmup을 백그라운드로 bound 처리해 provider discovery가 느려도 Slack 등 채널이 신속히 온라인이 되도록 수정.
- Slack/Socket Mode: 기본 15초 Slack SDK pong 타임아웃 적용 및
channels.slack.socketMode.clientPingTimeout/serverPingTimeout/pingPongLoggingEnabledoverride 추가로 stale-websocket 처리가 app-event 휴리스틱에 의존하지 않도록 수정. (#14248) - Channels/Telegram: 다중 봇 Telegram 계정 간 네이티브 승인 라우팅에서
approvals.exec/plugin.targets[].accountId를 존중. (#69916) - Channels/LINE: 인바운드 이미지/비디오/오디오/파일 다운로드를 임시 파일 대신
~/.openclaw/media/inbound/에 저장해/tmp정리 후에도 미디어를 읽을 수 있도록 수정. (#73370) - Channels/Telegram: 잘못된
/bot<TOKEN>TelegramapiRoot값을 런타임에서 정규화하고openclaw doctor --fix가 suffix를 제거하도록 수정. (#55387)
Version 2026.4.26 (2026-04-28)
변경사항
- Providers: 온보딩/정적 모델 카탈로그/문서/매니페스트 소유 엔드포인트 메타데이터를 갖춘 번들 Cerebras 플러그인 추가.
- CLI/migration: Claude Code/Claude Desktop의 지침, MCP 서버, skill, command prompt를 미리보기/적용하는 번들 Claude importer 추가.
- CLI/migration: plan, dry-run, JSON, 사전 백업, archive-only 보고를 갖춘
openclaw migrate및 번들 Hermes importer(설정, 메모리/플러그인 힌트, 모델 provider, MCP 서버, skill, 자격증명) 추가. - Matrix/E2EE: 암호화 활성화, recovery 부트스트랩, 검증 상태 출력을 한 번에 수행하는
openclaw matrix encryption setup추가. - Agents/compaction: 활성 JSONL이 너무 커지면 일반 로컬 compaction을 실행하는 opt-in
agents.defaults.compaction.maxActiveTranscriptBytespreflight 트리거 추가 (성공한 compaction이 이후 turn을 더 작은 후속 파일로 이동). - Control UI: JSON5를 파싱하고 reveal 전까지 민감 값을 redact하는 raw config pending-changes diff 패널 추가.
버그 수정
- Gateway/plugins: 단일 플러그인 항목의 schema config가 잘못되면 게이트웨이를 degraded 모드로 시작하고
openclaw doctor --fix가 해당 플러그인 config를 격리해 모든 채널을 crash-loop 시키지 않도록 수정. (#62976, #70371) - Local models:
baseUrl만 있는 custom provider를 Chat Completions adapter로 기본 처리하고 loopback 모델 요청을 자동 신뢰해 로컬 OpenAI 호환 proxy가/v1/chat/completions를 받도록 수정. (#40024) - MCP/bundle-mcp: CLI-native
type: "http"MCP 서버 항목을 OpenClawtransport: "streamable-http"로 정규화하고 doctor가 기존 config를 복구. (#72757) - Cron:
cron.maxConcurrentRuns를 전용cron-nested격리 agent-turn 레인에 적용해 병렬 cron job이 내부 LLM 실행에서 직렬화되지 않도록 수정. (#72707) - Memory/QMD: QMD
--maskcollection 패턴 플래그를 우선 사용해 root 메모리 인덱싱이 워크스페이스의 모든 markdown으로 넓어지지 않고MEMORY.md로 스코핑되도록 수정. (#65480)
Version 2026.4.25 (2026-04-27)
변경사항
- TTS/WhatsApp:
/tts latestread-aloud 지원(중복 억제)과 세션 스코프 auto-TTS override/tts chat on|off|default추가로 현재-chat 응답용 음성 노트 UX 완성. (#66032) - TTS/agents:
agents.list[].tts로 전역messages.tts를 덮어쓰는 per-agent voice 허용,/tts persona컨트롤 및 provider 인지 TTS persona 추가. (#70748) - Providers (TTS): Azure Speech(#51776), Xiaomi MiMo(#52376), Local CLI(#56239), Inworld(#55972), Volcengine/BytePlus Seed Speech(#55641) 번들 음성 provider 추가, ElevenLabs
eleven_v3카탈로그 포함. (#68321) - Control UI: Gateway chat용 PWA 설치 지원 및 Web Push 알림 추가. (#44590)
- Plugins/CLI: 영구 레지스트리를 명시적으로 검사/복구하는
openclaw plugins registry(--refresh) 추가,openclaw plugins list가 기본적으로 cold 영구 레지스트리 스냅샷을 읽도록 변경. - Diagnostics/Prometheus: 저-카디널리티 진단 메트릭용 보호된 scrape route를 가진 번들
diagnostics-prometheus플러그인 추가.
버그 수정
- Logging/sessions: 영구 세션 transcript 텍스트에 구성된 redaction 패턴을 적용해 transcript JSONL이 민감 텍스트를 평문으로 유지하지 않도록 수정. (#42982)
- Codex/agent: 최신 Codex 모델(gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.2)에서
--thinking minimal을 request build 시low로 변환해 첫 turn이 거부되지 않도록 수정. (#71946) - Agents/runtime: heartbeat/cron/exec wakeup을 가시 user prompt가 아닌 transient 런타임 컨텍스트로 제출해 합성 시스템 작업이 chat transcript에 남지 않도록 수정. (#66496, #66814)
- Logging:
logging.maxFileBytes에서 파일 로그를 회전하고 bounded 번호 아카이브를 유지, long-lived 로거가 당일 파일을 따르도록 수정. (#58583, #62381) - Installer/Linux: noninteractive dpkg/needrestart 설정으로 apt 설치를 실행해 Ubuntu 24.04
curl | bash설치가 Node.js/Git/빌드 도구 설치 중 멈추지 않도록 수정. (#41146)
Version 2026.4.24 (2026-04-25)
변경사항
- Plugins/Google Meet: 개인 Google 인증, Chrome/Twilio 실시간 세션, paired-node Chrome 지원, artifact/attendance export, 이미 열린 Meet 탭 recovery를 갖춘 번들 참가자 플러그인으로 Google Meet 추가. (#70765)
- Control UI/Talk: OpenAI Realtime 기반 브라우저 WebRTC 실시간 voice 세션과 전체 OpenClaw 에이전트로의
openclaw_agent_consult핸드오프 추가. - Providers/DeepSeek: DeepSeek V4 Flash/V4 Pro를 번들 카탈로그에 추가하고 V4 Flash를 온보딩 기본값으로 지정.
- Providers/Google: backend Voice Call 및 Google Meet 오디오 bridge용 Gemini Live 실시간 voice provider 추가.
- Browser: managed/existing-session 자동화용 viewport 좌표 클릭과
openclaw browser click-coords추가,browser.actionTimeoutMs(기본 60초) 추가. (#54452, #62589) - Dependencies/memory:
node-llama-cpp를 기본 설치에서 제외 (로컬 임베딩은 선택적 런타임 패키지 설치 시에만 로드). - Models/commands:
/models add를 deprecate (채팅 시도 시 deprecation 메시지). (#71175)
버그 수정
- Agents/heartbeat: heartbeat system prompt를 non-heartbeat run에 주입하지 않도록 해 일반 user 응답이
HEARTBEAT_OKack로 억제되지 않도록 수정. (#69079) - Browser/startup: 프로필별 동시 lazy-start 호출을 dedupe해 동시 browser tool 요청이 중복 Chrome 실행과
PortInUseError로 race하지 않도록 수정. (#61772) - Providers/DeepSeek: DeepSeek V4 thinking 활성 시 replayed assistant tool-call turn에 누락된
reasoning_contentplaceholder를 추가해 기존 세션을deepseek-v4-flash/deepseek-v4-pro로 전환 시 provider의 400 replay 검사를 통과하도록 수정. (#71372) - Agents/Gemini: reasoning-only/empty/planning-only Gemini turn을 재시도해 세션이 조용히 멈추지 않도록 수정. (#71074)
- Compaction: 명시적
agents.defaults.compaction.keepRecentTokens를 수동/compact에 존중하고 이전 요약을 눈덩이처럼 키우는 대신 safeguard 요약을 재정제. (#71357)
Breaking
- Plugin SDK/tool-result transforms: Pi 전용
api.registerEmbeddedExtensionFactory(...)호환 경로 제거. 번들 tool-result 재작성은 대상 harness를 선언하는contracts.agentToolResultMiddleware와 함께api.registerAgentToolResultMiddleware(...)를 사용해야 함.
Version 2026.4.23 (2026-04-24)
변경사항
- Providers/OpenAI: Codex OAuth를 통한 이미지 생성 및 reference-image 편집 추가로
OPENAI_API_KEY없이openai/gpt-image-2동작. (#70703) - Providers/OpenRouter:
image_generate를 통한 이미지 생성 및 reference-image 편집 추가로OPENROUTER_API_KEY로 OpenRouter 이미지 모델 동작. (#55066, #67668) - Agents/subagents: 네이티브
sessions_spawnrun을 위한 선택적 forked context 추가 (필요 시 자식이 requester transcript를 상속, 기본은 격리 세션 유지). - Agents/tools: image/video/music/TTS 생성 tool에 선택적 per-call
timeoutMs지원 추가. - Dependencies/Pi: 번들 Pi 패키지를
0.70.0으로 갱신하고 OpenAI/OpenAI Codex용gpt-5.5카탈로그 메타데이터 사용.
버그 수정
- Codex harness/Windows: npm 설치된
codex.cmdshim을 PATHEXT로 해석해 수동.exeshim 없이codex/*모델이 동작하도록 수정. (#70913) - Memory/CLI: 내장
local임베딩 provider를 memory-core 매니페스트에 선언해 standaloneopenclaw memory status/index/search가 로컬 임베딩을 해석하도록 수정. (#70836) - Media understanding: 명시적 image-model 설정(
agents.defaults.imageModel,tools.media.image.models)을 native-vision skip보다 우선 적용. (#47614, #63722, #69171) - Plugins/install:
openclaw를 peer dependency로 선언하는 외부 플러그인에 호스트 OpenClaw 패키지를 link해 설치 후 peer-only plugin SDK import가 해석되도록 수정. (#70462) - Memory/dreaming: managed dreaming cron을 heartbeat에서 분리해 격리된 lightweight agent turn으로 실행, heartbeat가 비활성이어도 dreaming이 실행되도록 수정. (#69811, #67397, #68972)
보안 수정
- Android/security: Android 수동/스캔 경로에서 loopback 전용 cleartext 게이트웨이 연결을 요구해 private-LAN·link-local
ws://엔드포인트가 TLS 미사용 시 fail-closed 되도록 수정. (#70722) - Pairing/security: cleartext 모바일 페어링에 private-IP 또는 loopback 호스트를 요구하고
.local/dotless 호스트명을 안전한 cleartext로 취급하지 않도록 수정. (#70721) - MCP/tools: ACPX OpenClaw tools bridge가
cron같은 owner-only tool을 나열/호출하지 못하도록 해 non-owner MCP 호출자의 권한 상승 경로를 차단. (#70698)
Version 2026.4.22 (2026-04-23)
변경사항
- Providers/xAI: 이미지 생성, TTS, STT 지원 추가 (
grok-imagine-image/grok-imagine-image-pro, reference-image 편집, 6개 라이브 xAI voice, MP3/WAV/PCM/G.711 TTS,grok-stt오디오 transcription, Voice Call 스트리밍용 xAI realtime transcription). (#68694) - Providers/STT: Deepgram, ElevenLabs, Mistral용 Voice Call 스트리밍 transcription 추가, ElevenLabs는 인바운드 미디어용 Scribe v2 배치 오디오 transcription 추가.
- TUI: 플러그인 승인 게이트는 유지하면서 Gateway 없이 터미널 채팅을 실행하는 로컬 embedded 모드 추가. (#66767)
- Models/commands: 게이트웨이 재시작 없이 채팅에서 모델을 등록하는
/models add <provider> <modelId>추가. (#70211) - WhatsApp: WhatsApp 대화용 구성 가능한 네이티브 reply quoting(
replyToMode) 추가. - Status:
/status에 세션이 embedded Pi, CLI 기반 provider, ACP harness 중 어디서 실행 중인지 표시하는Runner:필드 추가. (#70595)
버그 수정
- Providers/Moonshot: Kimi의 네이티브 tool_call ID(
functions.<name>:<index>형태)를 OpenAI 호환 전송에서 strict-sanitize하지 않도록 해 Kimi K2.6 multi-turn agentic 흐름이 2-3 라운드 후 깨지지 않도록 수정, opt-outsanitizeToolCallIds추가. (#62319) - Models/auth:
openclaw models auth login의 provider 소유 기본 모델 추가를agents.defaults.models교체가 아닌 merge로 처리해 OAuth provider 재인증이 다른 provider alias/파라미터를 지우지 않도록 수정. (#69414, #70435) - Anthropic/Claude Opus 4.7: Opus 4.7 및
claude-cliOpus 4.7 변형을 resolved 런타임 메타데이터에서 1M 컨텍스트 윈도우로 정규화해 stale 200k 폴백을 상속하지 않도록 수정. - Config/includes: 단일 파일 top-level include에 OpenClaw 소유 변경을 write-through 처리해
plugins install/update가 modular$includeconfig를 평탄화하지 않도록 수정. (#41050, #66048)
보안 수정
- Gateway/Control UI:
gateway.auth활성 시/__openclaw/control-ui-config.json제공 전 인증된 Control UI 읽기 접근을 요구해 미인증 호출자가 bootstrap 메타데이터를 읽지 못하도록 수정. (#70247) - Telegram: 그룹 모델-picker 콜백에 동일한
/models권한을 요구해 미승인 참가자가 인라인 버튼으로 세션 모델을 변경하지 못하도록 수정. (#70235) - OpenShell/sandbox: 검증된 파일 읽기를 이미 열린 descriptor에 고정하고 부모 symlink swap이 in-sandbox 읽기를 호스트 파일로 리다이렉트하지 못하도록 파일 identity 재검사. (#69798)
- Dependencies/security: 전이 의존성
uuid를14.0.0으로 override해 런타임 advisory 해소.
Version 2026.4.21 (2026-04-22)
가이드 반영 파일
52-multi-model.md, 42-memory-system.md, 31-cron.md, 12-telegram.md, 17-bluebubbles.md, 26-teams.md, 61-cli-commands.md, 53-security.md — 18개 stable 릴리즈(v2026.3.22~v2026.4.21) 변경사항 일괄 반영.
OpenClaw 릴리즈 변경사항
변경사항
- OpenAI/images: 번들 이미지 생성 provider 기본값을
gpt-image-2로 변경, 2K/4K OpenAI 사이즈 힌트 지원 추가.
버그 수정
- Auth/commands:
enforceOwnerForCommands=true+ownerAllowFrom미설정 시 wildcardallowFrom또는 빈 owner 후보 목록을 owner 권한으로 허용하지 않도록 강화. (#69774) - Slack:
threadTs공급 시 런타임 아웃바운드 전송에서 thread 별칭 보존. (#62947) - Browser: 잘못된
ax<N>접근성 참조를 타임아웃 없이 즉시 거부. (#69924) - npm/install:
node-domexception별칭을 루트package.jsonoverrides에 미러링하여 deprecated 의존성 체인 경고 제거.
Version 2026.4.20 (2026-04-21)
변경사항
- Cron: 런타임 실행 상태를
jobs-state.json으로 분리하여jobs.json은 git 추적용 job 정의로 안정적으로 유지. (#63105) - Moonshot/Kimi: 번들 기본값을
kimi-k2.6으로 변경,kimi-k2.5호환성 유지. (#69477) - Moonshot/Kimi:
kimi-k2.6에서thinking.keep = "all"허용, 다른 Moonshot 모델 또는tool_choice고정 시 제거. (#68816) - BlueBubbles/groups: 그룹별
systemPrompt설정을 인바운드 컨텍스트GroupSystemPrompt로 전달,"*"와일드카드 폴백 지원. (#69198) - Sessions/Maintenance: 기본 항목 상한 및 연령 정리 강제 적용, 로드 시 과다 저장소 정리로 OOM 방지. (#69404)
버그 수정
- BlueBubbles: 아웃바운드 전송 타임아웃 기본값 10초→30초 상향, macOS 26(Tahoe) Private API iMessage 전송 중단 방지. (#69193)
- Telegram: 폴링 감시 임계값 기본값 90초→120초 상향, 장시간 작업에서 중단(stalled) 오인 감소. (#57737)
Version 2026.4.15 (2026-04-16)
변경사항
- Anthropic/models: 기본 Anthropic 선택,
opus별칭, Claude CLI 기본값을 Claude Opus 4.7로 변경. - Google/TTS: 번들
google플러그인에 Gemini TTS 지원 추가 (음성 선택, WAV 응답 출력, PCM 텔레포니 출력). (#67515) - Memory/LanceDB:
memory-lancedb에 클라우드 스토리지 지원 추가로 원격 오브젝트 스토리지에서 영구 메모리 인덱스 운용 가능. (#63502) - GitHub Copilot/memory search: 메모리 검색용 GitHub Copilot 임베딩 provider 추가. (#61718)
- Packaging/plugins: 번들 플러그인 런타임 의존성을 소유 extension으로 로컬화하여 배포 패키지 경량화. (#67099)
보안 수정
- Gateway/tools: 클라이언트 제공 tool 이름이 내장 tool과 충돌 시
400 invalid_request_error반환, 내장 tool 로컬 미디어 신뢰 상속 방지. (#67303)
Version 2026.4.14 (2026-04-14)
변경사항
- OpenAI Codex/models:
gpt-5.4-pro전방 호환 지원 추가 (Codex 가격/한도 및 목록/상태 가시성 포함). (#66453) - Telegram/forum topics: 포럼 서비스 메시지에서 토픽 이름을 학습하여 에이전트 컨텍스트 및 플러그인 훅 메타데이터에 표시. (#65973)
버그 수정
- Models/Codex: codex provider 카탈로그 출력에
apiKey포함하여models.json의 모든 custom 모델이 자동 드롭되는 문제 수정. (#66180) - Tools/image+pdf: provider/model 참조 정규화로 Ollama 비전 모델이 거부되는 문제 수정. (#59943)
- Slack/interactions: 블록 액션 및 모달 이벤트에
allowFrom허용 목록 적용, 허용 목록 없는 채널에서 open-by-default 동작 유지. (#66028)
Version 2026.4.12 (2026-04-13)
변경사항
- Memory/Active Memory: 메인 응답 직전 전용 메모리 서브 에이전트를 실행하는 새 선택적 Active Memory 플러그인 추가 (
message/recent/fullcontextMode 설정 지원,/verbose검사, 프롬프트 오버라이드 튜닝). (#63286) - CLI/exec policy:
openclaw exec-policy명령 추가 (show,preset,set서브커맨드로tools.exec.*설정과 로컬 exec 승인 파일 동기화). (#64050) - Gateway:
commands.listRPC 추가로 원격 게이트웨이 클라이언트에서 런타임 명령 탐색 지원. (#62656) - Models/providers: 신뢰할 수 있는 자체 호스팅 OpenAI 호환 엔드포인트를 위한 per-provider
models.providers.*.request.allowPrivateNetwork추가. (#63671)
Version 2026.4.11 (2026-04-12)
변경사항
- Dreaming/memory-wiki: ChatGPT import 수집 +
Imported Insights,Memory Palace다이어리 서브탭 추가로 Dreaming에서 가져온 대화 및 위키 페이지 직접 검사 가능. (#64505) - Microsoft Teams: 리액션 지원, 리액션 목록 조회, Graph API 페이지네이션, 리액션 전송을 위한 위임 OAuth(delegated OAuth) 설정 추가 (기존 application-auth 읽기 경로 유지). (#51646)
- Tools/video_generate: URL 전용 에셋 전달, 타입화된
providerOptions, 참조 오디오 입력, per-asset 역할 힌트,adaptive가로세로비 지원 추가. (#61987, #61988) - Feishu: 문서 댓글 세션에 컨텍스트 파싱, 댓글 리액션, 타이핑 피드백 추가. (#63785)
- Plugins: 플러그인 매니페스트에서 활성화 및 설정 디스크립터 선언 지원으로 코어 하드코딩 없이 설정 플로우 기술 가능. (#64780)
버그 수정
- OpenAI/Codex OAuth: authorize URL 범위 재작성 중단으로 새 Codex 로그인 시
invalid_scope오류 해결. (#64713) - Audio transcription: OpenAI 호환 멀티파트 요청에만 DNS 핀 비활성화, OpenAI/Groq/Mistral 전사 기능 복구. (#64766)
Version 2026.4.10 (2026-04-11)
변경사항
- Models/Codex: 번들 Codex provider 및 app-server harness 추가 (
codex/gpt-*모델은 Codex 관리 인증·네이티브 스레드·모델 탐색·압축 사용,openai/gpt-*는 기존 OpenAI 경로 유지). (#64298) - Microsoft Teams: pin, unpin, read, react 및 리액션 목록 조회 메시지 액션 추가. (#53432)
- Tools/video generation: Seedance 2.0 모델 참조 및 provider별 duration, resolution, audio, seed 메타데이터 필드 추가.
Version 2026.4.9 (2026-04-09)
변경사항
- Memory/dreaming: 과거 일일 노트를 Dreams와 영구 메모리로 재생하는 grounded REM backfill 레인 추가 (
rem-harness --path지원, 다이어리 커밋/리셋 플로우, 내구성 있는 팩트 추출). - Plugins/provider-auth: provider 매니페스트에서
providerAuthAliases선언 지원으로 provider 변형 간 환경 변수 및 인증 프로파일 공유 가능. - iOS:
apps/ios/version.json에 CalVer 버전 핀 설정,pnpm ios:version:pin -- --from-gateway릴리즈 워크플로우 추가. (#63001)
보안 수정
- Browser/security: 상호작용 기반 메인 프레임 내비게이션 후 차단 대상 안전 검사 재실행으로 SSRF 우회 방지. (#63226)
- Security/dotenv: 신뢰할 수 없는 워크스페이스
.env파일에서 런타임 제어 환경 변수 및 브라우저 제어 오버라이드 차단. (#62660, #62663) - Gateway/node exec events: 원격 노드 exec 이벤트를 신뢰할 수 없는 시스템 이벤트로 표시하여 노드 출력으로 인한 프롬프트 인젝션 방지. (#62659)
Version 2026.4.8 (2026-04-08)
버그 수정
- Telegram/setup: npm 빌드에서
dist/extensions/telegram/src/*파일 누락으로 게이트웨이 시작 실패하는 문제 수정. - Bundled channels/setup: BlueBubbles, Feishu, Google Chat, IRC, Matrix, Mattermost, Teams, Nextcloud Talk, Slack, Zalo 채널 시작 시 누락 파일 문제 수정.
- Slack: Socket Mode WebSocket 연결에 HTTP(S) 프록시 설정 적용 (NO_PROXY 제외 포함). (#62878)
- Network/fetch guard: 신뢰할 수 있는 env-proxy 모드 활성화 시 대상 DNS 핀 설정 건너뜀으로 프록시 전용 샌드박스에서 아웃바운드 해결 가능. (#59007)
Version 2026.4.7 (2026-04-08)
변경사항
- CLI/infer: provider 기반 추론 워크플로우를 위한
openclaw infer허브 추가 (모델, 미디어, 웹, 임베딩 작업 지원). - Memory/wiki: 번들
memory-wiki스택 복원 (플러그인, CLI, 동기화/쿼리/적용 도구, 구조화된 claim/evidence 필드, 신선도 가중 검색 포함). - Plugins/webhooks: 번들 webhook 수신 플러그인 추가로 외부 자동화에서 per-route 공유 시크릿 엔드포인트를 통한 TaskFlow 구동 가능. (#61892)
- Gateway/sessions: 영구 compaction 체크포인트 + Sessions UI 브랜치/복원 액션 추가로 압축 이전 세션 상태 검사 및 복구 지원. (#62146)
- Providers/Google: Gemma 4 모델 지원 추가 및 Google 폴백 해결 경로 수정. (#61507)
- Providers/Arcee AI: 번들 Arcee AI provider 플러그인 추가 (Trinity 카탈로그, OpenRouter 지원). (#62068)
- Agents/system prompt:
agents.defaults.systemPromptOverride추가로 프롬프트 실험 및 heartbeat 프롬프트 섹션 제어 지원.
Version 2026.4.5 (2026-04-06)
Breaking 변경사항
- Config: 레거시 공개 설정 별칭 제거 (
talk.voiceId,talk.apiKey,browser.ssrfPolicy.allowPrivateNetwork등).openclaw doctor --fix로 마이그레이션. (#60726)
변경사항
- Agents/video generation: 내장
video_generate도구 추가로 에이전트가 설정된 provider를 통해 비디오 생성 및 응답에 직접 반환 가능. - Tools/music generation: 내장
music_generate도구 추가 (번들 Google Lyria, MiniMax provider 포함, Comfy 워크플로우 지원). - Providers: 번들 Qwen, Fireworks AI, StepFun provider 추가 및 MiniMax TTS, Ollama 웹 검색, MiniMax Search 통합. (#60032 외)
- Amazon Bedrock: 번들 Mantle 지원 및 추론 프로파일 자동 탐색 추가. (#61296)
- Control UI/multilingual: 한국어 포함 12개 언어 다국어 Control UI 지원 추가.
- Control UI/skills: ClawHub 검색·상세·설치 플로우를 Skills 패널에서 직접 제공. (#60134)
Version 2026.4.2 (2026-04-02)
Breaking 변경사항
- Plugins/xAI:
x_search설정을plugins.entries.xai.config.xSearch.*로 이전, 인증 표준화.openclaw doctor --fix로 마이그레이션. (#59674) - Plugins/web fetch: Firecrawl
web_fetch설정을plugins.entries.firecrawl.config.webFetch.*로 이전.openclaw doctor --fix로 마이그레이션. (#59465)
변경사항
- Tasks/Task Flow: 코어 Task Flow 기반 복원 (managed/mirrored 동기화 모드, 영구 flow 상태/리비전 추적,
openclaw flows검사/복구 프리미티브). (#58930) - Tasks/Task Flow: 관리형 자식 태스크 생성 및 sticky 취소 인텐트 추가. (#59610)
- Android/assistant: Android 어시스턴트 진입점 및 Google Assistant App Actions 메타데이터 추가. (#59596)
- Plugins/hooks:
before_agent_reply훅 추가로 플러그인이 LLM을 우회한 합성 응답 삽입 가능. (#20067)
Version 2026.4.1 (2026-04-01)
변경사항
- Tasks/chat:
/tasks명령으로 현재 세션의 백그라운드 태스크 보드 표시 (최근 태스크 상세, 에이전트 로컬 폴백 카운트 포함). - Web search/SearXNG: 번들 SearXNG provider 플러그인 추가 (
web_search용, 설정 가능한 호스트 지원). (#57317) - Amazon Bedrock/Guardrails: Bedrock Guardrails 지원 추가. (#58588)
- Cron/tools allowlist:
openclaw cron --tools로 job별 도구 허용 목록 설정 지원. (#58504) - Agents/failover: 동일 provider 인증 프로필 재시도 상한 추가,
auth.cooldowns.rateLimitedProfileRotations설정 노출. (#58707) - Telegram/errors:
errorPolicy및errorCooldownMs설정으로 계정·채팅·토픽별 반복 전송 오류 억제 지원. (#51914) - ZAI/models:
glm-5.1,glm-5v-turbo를 번들 Z.AI provider 카탈로그에 추가. (#58793)
Version 2026.3.31 (2026-03-31)
Breaking 변경사항
- Nodes/exec: CLI 및 에이전트
nodes도구에서 중복nodes.run셸 래퍼 제거, 노드 셸 실행은exec host=node로 통일. - Plugin SDK: 레거시 provider 호환 서브패스 및 번들 provider 설정 shim 제거,
openclaw/plugin-sdk/*엔트리포인트 사용 권장. - Skills/install and Plugins/install: 위험 코드
critical발견 시 기본 설치 실패, 계속하려면--dangerously-force-unsafe-install명시 필요. - Gateway/auth:
trusted-proxy에서 혼합 공유 토큰 설정 거부, 로컬 직접 폴백에 설정된 토큰 필요. - Gateway/node commands: 노드 페어링 승인 전까지 노드 명령 비활성화. (#57777)
변경사항
- Agents/LLM: 임베디드 runner 요청에 설정 가능한 유휴 스트림 타임아웃 추가로 중단된 모델 스트림 정리. (#55072)
- Agents/MCP: MCP 도구에
serverName__toolName형식 provider 안전 이름 적용,streamable-http전송 선택 및 per-server 연결 타임아웃 지원. (#49505) - ACP/plugins: 기본 비활성화 ACPX 플러그인 도구 MCP 브리지 설정 추가, 글로벌 설치 및 stdio MCP 세션 신뢰성 개선. (#56867)
- Android/notifications: 패키지 필터링이 포함된 알림 전달 제어 추가.
Version 2026.3.28 (2026-03-29)
Breaking 변경사항
- Providers/Qwen: 레거시
qwen-portal-authOAuth 통합 제거.openclaw onboard --auth-choice modelstudio-api-key로 마이그레이션. (#52709) - Config/Doctor: 2개월 이상 된 자동 설정 마이그레이션 제거, 아주 오래된 레거시 키는 로드 또는 doctor 실행 시 마이그레이션 대신 검증 오류 발생.
변경사항
- xAI/tools: 번들 xAI provider를 Responses API로 이전,
x_search1등급 지원 추가 및 xAI 플러그인 자동 활성화. (#56048) - MiniMax:
image-01모델용 이미지 생성 provider 추가 (가로세로비 제어, image-to-image 편집 지원). (#54487) - Plugins/hooks:
before_tool_call훅에 비동기requireApproval추가로 도구 실행 일시 중단 및 exec 승인 오버레이·Telegram 버튼·/approve명령을 통한 사용자 승인 요청 지원. (#55339) - OpenAI/apply_patch: OpenAI 및 OpenAI Codex 모델에서
apply_patch기본 활성화. - Plugins/CLI backends: Gemini CLI 백엔드 지원 추가, Claude CLI/Codex CLI/Gemini CLI를 플러그인 레이어로 이전. 수동
plugins.allow항목 불필요.
Version 2026.3.24 (2026-03-25)
변경사항
- Microsoft Teams: 공식 Teams SDK로 마이그레이션, AI 에이전트 UX 모범 사례 적용 (1:1 DM 스트리밍 응답, 프롬프트 스타터 포함 환영 카드, 피드백/성찰, 안내형 상태 업데이트, 타이핑 표시, 네이티브 AI 레이블링). (#51808)
- Microsoft Teams: 전송된 메시지 편집·삭제 기능 추가. (#49925)
- CLI/containers:
--container및OPENCLAW_CONTAINER환경 변수 추가로 실행 중인 Docker/Podman OpenClaw 컨테이너 내에서 명령 실행 지원. (#52651) - Gateway/OpenAI compatibility:
/v1/models,/v1/embeddings추가,/v1/chat/completions·/v1/responses에서 명시적 모델 오버라이드 전달. - Discord/auto threads:
autoThreadName: "generated"옵션으로 LLM 생성 스레드 이름 비동기 적용 지원. (#43366) - Skills/install metadata: 번들 스킬(coding-agent, gh-issues, openai-whisper-api 등)에 원클릭 설치 레시피 추가. (#53411)
Version 2026.3.23 (2026-03-23)
변경사항
- ModelStudio/Qwen: 중국 및 글로벌 Qwen API 키용 표준 DashScope 엔드포인트 추가, provider 그룹명을
Qwen (Alibaba Cloud Model Studio)로 변경. (#43878) - UI/clarity: 버튼 프리미티브 통합, Knot 테마를 WCAG 2.1 AA 대비의 블랙-레드 팔레트로 개선, CSP
script-src에 인라인 스크립트 SHA-256 해시 추가. (#53272, #53307)
버그 수정
- Plugins/bundled runtimes: npm 전역 설치에서 누락된 번들 플러그인 런타임 사이드카 파일 복구 (WhatsApp, Matrix 등).
- Auth/OpenAI tokens: Configure/Onboard 플로우에서 새로 저장된 자격 증명이 오래된 인메모리 값으로 되돌아가는 문제 수정. (#53207 수정)
- Plugins/ClawHub: 설치 시 현재 런타임 버전에 맞춰 플러그인 API 호환성 검사, 구식
1.2.0상수로 인한 설치 실패 수정. (#53157)
Version 2026.3.22 (2026-03-23)
Breaking 변경사항
- Plugins/install: npm-safe 이름에 대해 ClawHub를 npm보다 우선 검색, ClawHub에 없는 경우에만 npm 폴백.
- Browser/Chrome MCP: 레거시 Chrome 확장 릴레이 경로 및 번들 확장 에셋 제거.
openclaw doctor --fix로existing-session/user로 마이그레이션. - Tools/image generation: 번들
nano-banana-pro스킬 래퍼 제거. 대신agents.defaults.imageGenerationModel.primary사용. - Plugins/SDK: 공개 플러그인 SDK 표면을
openclaw/plugin-sdk/*로 변경,openclaw/extension-api제거 (호환 심 없음). - Config/env: 레거시
CLAWDBOT_*및MOLTBOT_*환경 변수 호환 이름 제거.
변경사항
- Skills/
skills명령: ClawHub 네이티브 검색·설치·업데이트 플로우 지원 추가. - Chat command/
/btw: 현재 세션 컨텍스트 변경 없이 빠른 답변을 얻는 사이드 질문 채팅 명령 추가. - Plugins/Matrix: 공식
matrix-js-sdk기반 새 Matrix 플러그인 추가. 기존 공개 Matrix 플러그인 사용자는 마이그레이션 가이드 참고.
Version 1.0.0 (2026-03-16)
한국어 가이드 마이그레이션
한국어 가이드 최초 마이그레이션 — 54개 파일
기존 openclaw-guide/docs/에서 src/content/guides/openclaw/로 54개 가이드 파일 마이그레이션 완료.
마이그레이션된 섹션
- 시작하기 (oc-getting-started): 설치, 첫 메시지, 기본 개념
- 채널 - 주요 (oc-channels-main): Slack, Telegram, Discord, WhatsApp
- 채널 - 추가 (oc-channels-more): BlueBubbles, Line, Telegram Groups, Kakao, IRC, Feishu, Google Chat, Zalo, Instagram, Mattermost, Nextcloud, YouTube, VoIP/SIP, Teams, Discord Advanced
- 자동화 (oc-automation): Heartbeat, Cron, Use Cases
- 스킬 (oc-skills): 개요, 기본 사용, 커스텀 개발, 라이브러리
- 워크스페이스 (oc-workspace): 구조, 메모리 시스템, 모범 사례
- 고급 (oc-advanced): 서브 에이전트, 브라우저 자동화, 멀티 모델, 보안
- 참고 (oc-reference): CLI 명령어, 설정 파일, 환경 변수
- 문제 해결 (oc-troubleshooting): 일반 오류
- 부록 (oc-appendix): 용어 사전, 변경 이력, 외부 자료
Version 0.1.0 (2026-02-23)
초기 릴리스
초기 한국어 가이드 문서 공개
추가된 문서
시작하기 (01-getting-started)
- installation.md - 설치 가이드 (Desktop, Docker, CLI)
- first-message.md - 첫 메시지 보내기
- basic-concepts.md - 기본 개념 (Gateway, Session, Agent)
채널 설정 (02-channels)
- overview.md - 채널 개요 및 선택 가이드
- slack.md - Slack 설정 가이드
- telegram.md - Telegram 설정 가이드
- discord.md - Discord 설정 가이드
자동화 (03-automation)
- heartbeat.md - Heartbeat 기능 가이드
- cron.md - Cron 스케줄링 가이드
- use-cases.md - 실전 활용 예시
스킬 (04-skills)
- overview.md - 스킬 개요
- using-skills.md - 기본 스킬 사용법
- creating-skills.md - 커스텀 스킬 개발
- skill-library.md - 유용한 스킬 모음
워크스페이스 & 메모리 (05-workspace-memory)
- workspace.md - 워크스페이스 구조
- memory-system.md - 메모리 시스템 (QMD)
- best-practices.md - 모범 사례
고급 기능 (06-advanced)
- sub-agents.md - 서브 에이전트
- browser-automation.md - 브라우저 자동화 (Playwright)
- multi-model.md - 다중 모델 설정
- security.md - 보안 가이드
참고 문서 (07-reference)
- cli-commands.md - CLI 명령어 참조
- configuration.md - 설정 파일 참조
문제 해결 (08-troubleshooting)
- common-errors.md - 일반적인 오류 20개
부록 (09-appendix)
- glossary.md - 용어 사전
- changelog.md - 변경 이력 (이 문서)
- resources.md - 외부 자료 링크
특징
번역 원칙:
- Core Brand 용어 영어 유지 (OpenClaw, Gateway, ClawHub)
- 기술 개념 한국어 + 영어 병기 (워크스페이스(workspace))
- UI 요소 한국어 관습 따름 (설정, 채널)
- CLI 명령어 영어 유지
문서 스타일:
- Progressive Disclosure 패턴 적용
- Diátaxis Framework 기반 구조
- 코드 예시 포함
- 다이어그램/표 포함
변경 유형
| 유형 | 설명 |
|---|---|
| Added | 새로운 문서 또는 섹션 추가 |
| Changed | 기존 내용 수정 |
| Deprecated | 향후 제거 예정인 기능 |
| Removed | 제거된 문서 또는 섹션 |
| Fixed | 오류 수정 |
| Security | 보안 관련 수정 |
피드백
문서 개선을 위한 피드백을 환영합니다!
- GitHub Issues: 버그 신고 및 기능 요청
- GitHub Pull Requests: 직접 기여
- Discord: OpenClaw 한국어 채널