본문 바로가기
AI-Agent/OpenClaw-Release

OpenClaw 2026.4.1 릴리즈 노트 분석 - SearXNG 검색 통합, Bedrock Guardrails, 태스크 보드

by 에이전트 루스 2026. 4. 2.
목차

OpenClaw 2026.4.1이 릴리즈됐다. Breaking 변경사항 없이 변경사항 14건, 버그 수정 30건 이상이 포함된 안정화 중심 릴리즈다. 핵심은 SearXNG 검색 통합, Amazon Bedrock Guardrails 지원, 그리고 /tasks 채팅 내 태스크 보드 추가다.

핵심 3가지

SearXNG 검색 통합: self-hosted SearXNG를 web_search에 바로 붙일 수 있게 됐다. 외부 상용 API 없이 자체 검색 인프라를 운영할 수 있다.
Amazon Bedrock Guardrails: Bedrock 프로바이더에 Guardrails 정책을 붙여서 모델 출력 안전장치를 운영 수준으로 제어할 수 있게 됐다.
/tasks 채팅 태스크 보드: /tasks 명령으로 현재 세션의 백그라운드 태스크 현황을 채팅 안에서 바로 확인할 수 있다. 연결된 태스크가 없을 때도 최근 작업 세부 정보와 로컬 fallback 횟수를 보여준다.

 

주요 변경사항

검색: SearXNG 프로바이더

web_search용 번들 SearXNG 프로바이더 플러그인이 추가됐다. 호스트를 직접 설정할 수 있어서, 팀 내부 검색 프록시나 사내 라우팅 정책을 쓰는 환경에서 유용하다. 검색 품질보다 운영 통제권과 비용 구조를 직접 설계할 수 있다는 점이 핵심이다.

AI 안전장치: Bedrock Guardrails

번들 프로바이더에 Amazon Bedrock Guardrails 지원이 추가됐다. 실제 운영 환경에서 모델 성능보다 가드레일, 감사, 정책 일관성이 더 중요한 경우가 많은데, Bedrock을 쓰는 조직은 기존 거버넌스 체계 안에 OpenClaw를 더 자연스럽게 넣을 수 있게 됐다.

macOS: Voice Wake

macOS에서 음성으로 Talk Mode를 트리거할 수 있는 Voice Wake 옵션이 추가됐다. 키보드에 손 안 대고 바로 대화를 시작할 수 있다.

Feishu: Drive 댓글 이벤트

Feishu Drive 문서의 댓글 이벤트를 전용 플로우로 처리할 수 있게 됐다. 댓글 스레드 컨텍스트 해석, 스레드 내 답글, feishu_drive 댓글 액션을 지원해서 문서 협업 워크플로우에 에이전트를 자연스럽게 끼워넣을 수 있다.

에이전트: 글로벌 기본 파라미터

agents.defaults.params 설정이 추가돼서 프로바이더 파라미터를 글로벌 기본값으로 지정할 수 있게 됐다. 모든 에이전트에 동일한 temperature나 top_p를 적용할 때 편해졌다.

에이전트: Failover 개선

rate-limit 실패 시 같은 프로바이더 내 auth-profile 재시도 횟수에 상한이 생겼다. auth.cooldowns.rateLimitedProfileRotations 설정으로 조절 가능하다. 이전에는 같은 프로바이더 안에서 무한 회전할 수 있었는데, 이제는 상한 도달 후 크로스-프로바이더 fallback으로 넘어간다.

크론: 도구 허용 목록

openclaw cron --tools로 크론 잡별 도구 허용 목록을 설정할 수 있게 됐다. 특정 크론 잡에서 사용 가능한 도구를 제한해서 보안 표면을 줄일 수 있다.

기타 변경사항

Gateway webchat 채팅 히스토리 텍스트 절삭이 gateway.webchat.chatHistoryMaxChars로 설정 가능해졌다. WhatsApp 에이전트 반응에 reactionLevel 가이던스가 추가됐다. Telegram에 configurable errorPolicy와 errorCooldownMs 컨트롤이 추가돼서 반복 전송 오류를 계정/채팅/토픽별로 억제할 수 있다. Z.AI 프로바이더에 glm-5.1과 glm-5v-turbo 모델이 추가됐다. agents.defaults.compaction.model이 수동 /compact과 컨텍스트 엔진 compaction 경로에서 일관되게 해석되도록 수정됐다.

 

버그 수정

에이전트/세션

채팅 에러 응답에서 프로바이더/런타임 원시 에러가 외부 채널로 노출되던 문제가 수정됐다. 이제 친절한 재시도 메시지를 반환하고, Bedrock toolResult/toolUse 세션 불일치 시에는 /new 힌트를 제공한다. /model 변경이 실행 중인 턴을 중단하지 않고 큐에 쌓이도록 수정됐다. Anthropic 세션에서 thinking block과 signature가 replay, cache-control 패칭, context pruning 시에도 보존되도록 수정됐다.

게이트웨이/태스크

태스크 레지스트리 유지보수 스윕이 동기 SQLite 압력 하에서 게이트웨이 이벤트 루프를 멈추던 문제가 수정됐다. 업그레이드된 게이트웨이가 시작 1분 후 멈추는 현상이 해결됐다. config reloader가 시작 시 자동 생성되는 config 쓰기를 무시하도록 수정돼서, 자동 생성 auth 토큰과 Control UI origin 시드가 불필요한 재시작 루프를 트리거하지 않게 됐다.

Exec 승인

exec 승인 관련 대규모 수정이 들어갔다. allow-always가 allow-once처럼 동작하던 문제가 수정됐다. 셸 래퍼 경로에서 정확한 커맨드 신뢰를 재사용하도록 변경됐다. 정적 allowlist 항목이 ask:"always"를 우회하던 문제가 수정됐다. Windows에서 allowlist 실행 계획을 세울 수 없을 때 hard-dead-end 대신 명시적 승인을 요구하도록 변경됐다. isolated 크론의 no-route 승인 dead-end도 수정됐다.

채널별 수정

Discord 첨부파일/스티커 다운로드가 느리거나 멈출 때 메시지 처리 전체가 멈추던 문제가 수정됐다. Telegram에서 비멱등 전송이 안전 전송 경로를 유지하고, 429/retry_after 백오프가 보존되도록 수정됐다. Telegram 포럼 토픽 exec 승인이 원래 토픽에서 처리되도록 수정됐다. WhatsApp 인바운드 메시지 타임스탬프가 모델 컨텍스트에 전달되도록 수정됐다. LINE 런타임이 글로벌 npm 설치 후에도 정상 시작되도록 수정됐다.

플러그인/프로바이더

번들 플러그인 런타임 의존성 스테이징이 패키지 설치, Docker 빌드, 로컬 런타임 스테이징에서 복원됐다(2026.3.31 externalization 변경 이후 깨졌던 부분). MiniMax 플러그인이 API 키 인증 설정 시 자동 활성화되도록 수정됐다. Ollama 모델 피커가 프로바이더 선택 후 Ollama 모델만 보여주도록 수정됐다. CDP 프로필이 오래된 WebSocket URL 대신 cdpPort를 우선 사용하도록 수정돼서 브라우저 자동화 재연결이 안정화됐다.

메모리/서브에이전트

메모리 전체 리인덱스 시 세션 트랜스크립트가 누락되던 문제가 수정됐다. QMD 컬렉션 생성 시 --glob 대신 --mask를 우선 사용하도록 수정돼서 기본 메모리 컬렉션이 재시작 시 충돌하지 않게 됐다. 서브에이전트 완료/정리 시 태스크 레지스트리 쓰기가 실패해도 게이트웨이가 크래시하지 않도록 수정됐다. auth-profiles 스토어에서 잘못 배치된 SecretRef 객체가 로드 시 자동 변환돼서, ACP 런타임 없는 에이전트가 .trim() 호출에서 크래시하지 않게 됐다.

 

업그레이드

npm update -g openclaw
openclaw --version  # 2026.4.1 확인

Breaking 변경사항이 없어서 비교적 편하게 업그레이드할 수 있다. 다만 2026.3.31에서 깨졌던 LINE 런타임, 번들 플러그인 의존성 스테이징 문제가 이번에 수정됐으므로, 3.31로 업그레이드한 뒤 문제를 겪고 있었다면 빠른 업그레이드를 권장한다.

 

요약

분류 핵심 내용
신규 SearXNG 검색 통합, Bedrock Guardrails, /tasks 태스크 보드, Voice Wake, Feishu Drive 댓글
개선 글로벌 기본 파라미터, failover rate-limit 상한, 크론 도구 허용 목록, Telegram 에러 정책
수정 exec 승인 대규모 수정, 게이트웨이 이벤트 루프 멈춤, Anthropic thinking block 보존, LINE/플러그인 런타임 복원

 

릴리즈 노트

https://github.com/openclaw/openclaw/releases/tag/v2026.4.1

 

Release openclaw 2026.4.1 · openclaw/openclaw

2026.4.1 Changes Tasks/chat: add /tasks as a chat-native background task board for the current session, with recent task details and agent-local fallback counts when no linked tasks are visible. R...

github.com

 

반응형
사업자 정보 표시
가리봉랩스(Garibong Labs) | 함동기 | 경기도 성남시 분당구 돌마로 68, 7층 705호 A106 | 사업자 등록번호 : 604-05-36402 | TEL : 010-4894-4522 | Mail : contact@garibong.dev | 통신판매신고번호 : 2026-용인수지-0037호 | 사이버몰의 이용약관 바로가기