career

오픈클로(OpenClaw) 2026.10.5 정식 업데이트 후기 — 툴 승인 훅 정책이 바뀐 판, 자동화 파이프라인 점검 포인트 (2026.10.19)

OpenClaw 공식 홈페이지 대표 이미지 — 오픈소스 AI 에이전트 OpenClaw OpenClaw 공식 홈페이지(openclaw.ai) 대표 이미지 — “The AI that really does things. Any OS. Any Platform.” (출처: openclaw.ai)

📌 한줄 요약: 업무 자동화 파이프라인에 AI 에이전트를 붙여 쓰는 분들이라면, 이번 건은 “또 패치 나왔네”로 넘길 소식이 아닙니다. 2026년 10월 19일 오전 6시 47분(KST), OpenClaw가 2026.10.5 정식판을 배포했습니다. 신기능만 보면 X 채널·음성 통화 확장이 눈에 띄지만, 실무에서 더 무거운 건 툴 승인 훅(tool approval hooks) 정책 변경입니다. 인자를 변형하는 플러그인을 쓰고 있다면 업그레이드 후 조용히 차단될 수 있는 종류의 변경입니다.

이 글을 읽으면 알 수 있는 것

  • 2026.10.5 정식판에서 무엇이 바뀌었고, 왜 2026.10.4와 결이 다른지
  • 툴 승인 훅 정책 변경이 기존 플러그인·자동화에 미치는 실제 영향
  • 재시작 안전 대화 복구가 크론 기반 자동화에서 갖는 의미
  • ClawHub 게이트웨이 내장, X 채널 정식 편입, 음성 통화 확장의 실무 포인트
  • 올리기 전에 확인해야 할 업그레이드 체크리스트

도입: “패치가 잦다는 건, 그만큼 경계가 바뀌고 있다는 뜻”

업무 자동화 파이프라인에 AI 에이전트를 붙여 운영하는 분들이라면 공감할 텐데, 10월 들어 OpenClaw의 릴리스 간격이 눈에 띄게 짧아졌습니다. 2026.10.1(10월 11일) → 2026.10.2 → 2026.10.3 → 2026.10.4(10월 16일) → 2026.10.5(10월 19일) 로 이어지는 흐름입니다. 숫자만 보면 “마이너 패치가 하나 더” 같지만, 이번 판은 릴리스 노트에 인용된 고유 PR 참조가 1,200개를 넘습니다. 단순 버그픽스 묶음이 아니라, 베타 채널에서 굴리던 기능이 정식 라인으로 올라오면서 정책과 기본값까지 함께 정리된 판입니다.

특히 이번 릴리스는 “기능이 늘었다” 보다 “자동화가 조용히 실패할 수 있는 지점이 생겼다” 는 쪽에 무게가 실립니다. 그래서 오늘은 GitHub 공식 릴리스 노트와 OpenClaw 공식 문서를 기준으로, 업그레이드 전에 꼭 봐야 할 것만 정리했습니다.

1. 무슨 일이 있었나 — 10월 릴리스 흐름 정리

먼저 사실관계부터. GitHub 공식 릴리스 기준 최근 흐름은 이렇습니다.

태그 배포 시각(KST) 성격
2026.10.3 2026-10-13 Doctor/업그레이드 수정, 대화 복구 패치
2026.10.4 2026-10-16 09:36 안정성 패치 (신기능·설정 변경 없음 명시)
2026.10.10-beta.1 2026-10-16 03:03 베타 라인 (게이트웨이 성능 중심)
2026.9.33 2026-10-15 19:39 확장 안정판(LTS 성격) — 보안 수정 포함
2026.10.5 2026-10-19 06:47 정식판 — 신기능 + 정책 변경

정리하면, 2026.10.4는 릴리스 노트에 “Stability patch for 2026.10.3 with no new features or configuration changes“라고 스스로 못박은 안정화 판이었습니다. 반면 2026.10.5는 Highlights에 신기능이 다섯 줄 넘게 올라온 판입니다. 즉 이번 주에 올릴 이유가 있다면 그건 안정성이 아니라 기능과 정책입니다.

OpenClaw GitHub 공식 릴리스 페이지 — v2026.10.5 OpenClaw GitHub 공식 릴리스(v2026.10.5, 게시 2026-10-18 21:47 UTC = 2026-10-19 06:47 KST) (출처: github.com/openclaw/openclaw/releases)

2. 핵심 ① — 툴 승인 훅 정책 변경 (이번 판의 진짜 본론)

이번 릴리스에서 가장 중요한 항목은 신기능이 아니라 Changes의 첫 줄입니다.

Tool approval hooks: 일반 훅(ordinary hooks)은 신뢰된 인라인 승인(trusted-inline-approved)을 거친 툴 인자를 추가 승인 없이 다시 쓸 수 없습니다. 인자를 변형(transforming)하는 플러그인은 최종 인자에 대해 별도 승인을 요청해야 하며, 그러지 않으면 호출이 차단됩니다. 마이그레이션은 docs/plugins/hooks/tool-policy.md 참고. (#142700)

풀어서 설명하면 이렇습니다.

  • 기존에는 before_tool_call 같은 훅에서 툴 인자를 살짝 손봐서 넘기는 패턴이 흔했습니다. 경로를 정규화하거나, 위험한 플래그를 제거하거나, 사내 규칙에 맞게 커맨드를 감싸는 식입니다.
  • 이번 판부터는 그 인자가 이미 “신뢰된 인라인 승인”을 통과한 상태라면, 일반 훅이 말없이 덮어쓸 수 없습니다.
  • 인자를 바꾸는 플러그인은 최종 인자에 대한 승인을 따로 받아야 하고, 그 절차가 없으면 호출 자체가 막힙니다.

실무적으로 무서운 지점은 “에러가 나면서 멈춘다”가 아니라 “정책상 차단된다” 는 점입니다. 승인 게이트에서 막히면 자동화 입장에서는 그냥 툴 호출이 실패한 것으로 보이고, 상위 워크플로는 재시도나 대체 경로로 빠질 수 있습니다. 즉 플러그인이 조용히 무력화되는 형태로 나타날 수 있습니다.

OpenClaw 공식 문서 — 플러그인 훅 툴 정책(tool-policy) 페이지 OpenClaw 공식 문서의 플러그인 훅 툴 정책(tool-policy) 페이지 — 이번 릴리스에서 마이그레이션 기준 문서로 지정됐습니다 (출처: docs.openclaw.ai/plugins/hooks/tool-policy)

누가 영향받나

사용 패턴 영향 대응
훅에서 인자만 읽고 로깅·검증만 하는 플러그인 영향 없음 그대로 사용
훅에서 경로·커맨드·파라미터를 변형하는 플러그인 차단 가능 최종 인자 승인 요청 추가
인자를 변형하는 사내 커스텀 플러그인 차단 가능 tool-policy.md 기준으로 마이그레이션
승인 게이트를 우회하려는 목적의 훅 의도적 차단 설계 재검토

솔직히 이건 불편해지는 변경이 맞습니다. 다만 방향은 분명합니다. “에이전트가 승인받은 것과 실제로 실행되는 것이 달라지는 경로”를 막는 것입니다. 사람이 승인한 인자와 실행되는 인자가 어긋나면, 그게 바로 자동화에서 가장 위험한 구멍이니까요.

3. 핵심 ② — 재시작을 넘어가는 대화, 끊겨도 이어지는 자동화

이번 판의 두 번째 축은 복구력입니다. 릴리스 노트 기준으로 정리하면 이렇습니다.

  • 중단된 턴(interrupted turns) 이 게이트웨이 재시작 후 이어서 진행됩니다. 워크트리 준비 중에 들어온 첫 메시지, 하위 에이전트(subagent) 작업, 지연된 태스크도 포함입니다.
  • 사용자 입력과 커밋된 세션 데이터가 재시작·동시 쓰기·발행 실패를 견딥니다.
  • 재시작 시점에 진행 중이던 메인 세션은 다음 부팅에서 재개되고, 중단된 완료 응답은 유실되지 않고 전달됩니다.
  • 서브에이전트 결과가 재시작을 넘어 부모에게 돌아옵니다.

크론잡으로 주기 작업을 돌리는 입장에서 이 변화는 체감이 큽니다. 기존에는 게이트웨이가 한 번 재시작되면 “돌던 작업은 사라지고, 다음 스케줄을 기다리는” 구조였습니다. 이제는 중간 상태가 남고, 복구가 호스트 쪽에서 조정(reconciliation) 됩니다. 야간 배치가 업데이트와 겹쳐도 결과가 통째로 날아갈 확률이 줄어드는 셈입니다.

함께 눈여겨볼 항목이 자동화 복구(automation repair) 입니다.

  • 실패한 자동화를 소유 대화(owner conversation)에서 먼저 복구 시도하고, 그다음에 알림을 보냅니다.
  • 오류 내용이 바뀌면 두 번째 복구 턴을 줍니다.
  • 복구 턴이 타임아웃되면 명확한 경고를 남깁니다.

“실패 → 알림 폭탄”이 아니라 “실패 → 자가 복구 시도 → 그래도 안 되면 알림” 으로 순서가 바뀐 겁니다. 알림 피로가 심했던 파이프라인이라면 체감 차이가 큽니다.

4. 핵심 ③ — 채널 확장: X 정식 편입, 음성 통화는 실무 기능으로

베타 채널에서 먼저 굴리던 기능이 정식 라인으로 올라왔습니다.

X(트위터) 멘션 채널 플러그인

  • Activity API 스트리밍 + 백필로 멘션을 수집합니다.
  • 기본값은 허용 목록(allowlist) 작성자만 응답 트리거이고, 나머지는 조용히 무시합니다.
  • 저장소 관련 질문에 한해 게스트 모드로 응답 범위를 넓힐 수 있습니다.
  • 쓰기 동작은 GitHub 검증을 거친 저장소 작성자로 제한됩니다.
  • 일일·월간 X API 비용 한도를 강제합니다.

음성 통화

  • 통화별 브리핑(per-call briefs), 통화 리포트, 실시간 개입(live steering), 콜백, 보이스메일 감지가 추가됐습니다.

자동화 관점에서 중요한 건 기능 목록이 아니라 비용·권한 기본값입니다. X API는 사용량 과금이 붙는 채널이라, 한도 강제가 기본으로 들어온 건 운영자 입장에서 반가운 부분입니다. 반대로 “일단 켜두면 다 응답”이 아니라 allowlist 기반이라는 점은, 문의 응대 자동화를 붙일 때 초기 세팅을 반드시 손봐야 한다는 뜻입니다.

5. 핵심 ④ — 게이트웨이는 가벼워지고, ClawHub는 안으로 들어왔습니다

ClawHub 게이트웨이 내장

  • 게이트웨이 안에서 ClawHub의 플러그인·스킬을 검색·탐색할 수 있습니다.
  • 플러그인은 현재 OpenClaw가 지원하는 최신 공식 릴리스를 자동으로 고릅니다. 맞는 릴리스가 없을 때는 동작하던 플러그인을 유지합니다.

워커 로컬 추론(worker-local inference)

  • 게이트웨이 디스패치, 클라이언트 배치, 필수 워커 정책과 목적지 검사를 거친 뒤 로컬 추론을 실행하는 네이티브 런타임이 추가됐습니다. 설정 실패 시 원인을 설명해 줍니다.

성능

  • 세션·트랜스크립트·히스토리·메타데이터 읽기가 워커 스레드로 이동하고, 턴당 SQLite 작업량이 줄었습니다.
  • 시작 시 유지보수 작업이 준비 완료 이후로 밀렸고, 게이트웨이 시작과 메모리 검색 워커의 메모리 사용량도 낮아졌습니다.

에이전트를 여러 개 굴리거나 세션이 길어지면 게이트웨이 메인 스레드가 병목이 되기 쉽습니다. 이번 판은 그 지점을 구조적으로 건드렸다는 데 의미가 있습니다.

6. 보안 경계 — 조용히 조여진 부분들

Highlights에 안 나와서 놓치기 쉬운데, Fixes 항목에 보안 경계 강화가 꽤 들어 있습니다.

  • 임시 루트 사용 여부를 증명할 수 없으면 fail closed — 프로세스 목록으로 확인이 안 되면 열어주지 않고 닫습니다.
  • 브라우저 페어링 자격증명이 opener 프로세스 인자에 남지 않도록 처리했습니다.
  • 셋업 진단(setup diagnostics)이 상태를 복구하기 전에 승인을 요구합니다.
  • file: SQLite 대상이 exec 라이브 상태 가드 검사 전에 확장되도록 순서를 바로잡았습니다.
  • 채널 보안: X allowlist에서 제거된 발신자가 인가 도중 디스패치에 도달하는 문제를 막고, Discord PluralKit·LINE·Tlon 오류 본문의 자격증명을 마스킹합니다.

자동화를 오래 굴리면 “권한은 넓게, 검증은 나중에”로 굳어지기 쉽습니다. 이번 판은 그 반대 방향으로 기본값을 당긴 릴리스입니다.

7. 업그레이드 체크리스트 — 올리기 전에 이 순서로

정식판이 나왔다고 바로 전부 올리는 건, 특히 플러그인을 쓰는 환경에서는 권하지 않습니다. 순서를 이렇게 잡으면 사고를 줄일 수 있습니다.

  1. 플러그인 인벤토리 확인 — 훅에서 툴 인자를 변형하는 플러그인이 있는지부터 셉니다. 없으면 이번 변경의 영향권 밖입니다.
  2. tool-policy.md 읽고 마이그레이션 — 변형 플러그인이 있다면 최종 인자 승인 요청을 추가합니다.
  3. 스테이징에서 1회 실행 — 실제 워크플로를 한 번 돌려 툴 호출이 차단되는지 확인합니다. 에러 메시지가 애매하게 나오는 유형이라 로그를 같이 봐야 합니다.
  4. 백업 — 세션 DB와 워크스페이스(IDENTITY.md, MEMORY.md, memory/)는 업그레이드 전에 스냅샷을 떠 둡니다. 10월 초 워크스페이스 초기화 사고를 겪은 라인이라, 이 습관은 계속 유지하는 편이 안전합니다.
  5. 크론잡은 일시 정지 후 업그레이드 — 재시작 복구가 좋아졌어도, 업그레이드 중에 스케줄이 겹치면 검증이 어려워집니다.
  6. LTS 라인 고정 여부 판단 — 확장 안정판(2026.9.x)에 머무는 운영이라면, 이번 정책 변경은 급하지 않습니다. 다만 신기능(ClawHub 내장, X 채널)이 필요하면 정식 라인으로 넘어와야 합니다.

마무리: “이번 판은 기능보다 경계를 봐야 하는 릴리스”

정리하면 이렇습니다.

  • 신기능만 원한다면: X 채널 정식 편입, 음성 통화 확장, ClawHub 게이트웨이 내장이 바로 쓸 만한 변화입니다.
  • 자동화를 안정적으로 굴리는 게 목적이라면: 이번 판의 본론은 툴 승인 훅 정책 변경입니다. 플러그인이 인자를 변형한다면 업그레이드 전에 마이그레이션이 필수입니다.
  • 운영 안정성이 급한 환경이라면: 재시작 복구·게이트웨이 성능 개선은 분명한 이득이니, 스테이징 검증 후 올리는 편이 낫습니다.

무료 오픈소스(Apache 2.0)로 이 정도 복구력과 정책 계층을 갖춘 에이전트 플랫폼은 흔하지 않습니다. 다만 빠르게 바뀌는 만큼, 업그레이드 노트를 읽는 사람과 안 읽는 사람의 차이가 크게 벌어지는 시기이기도 합니다. 업무 자동화에 에이전트를 붙여 쓰는 분들이라면, 이번 주는 릴리스 노트의 Changes 첫 줄만은 꼭 확인해 보시길 권합니다.

참고 자료

  • OpenClaw GitHub 릴리스 v2026.10.5 — https://github.com/openclaw/openclaw/releases/tag/v2026.10.5
  • OpenClaw 공식 문서, 릴리스 노트 — https://docs.openclaw.ai/releases
  • OpenClaw 공식 문서, 플러그인 훅 툴 정책 — https://docs.openclaw.ai/plugins/hooks/tool-policy
  • OpenClaw 공식 문서, 보안 — https://docs.openclaw.ai/gateway/security