한국어

← 목록으로

시작하자마자 가동! OpenClaw 5.22, 게이트웨이 성능 4100배로 끌어올리다 — AI 어시스턴트는 더 이상 느릴 핑계가 없다

itadol5j

커버

새벽 1시, OpenClaw 팀이 2026.5.22 버전을 내놓았습니다. 이번의 하이라이트는 새 모델도, 새 스킨도 아니라 Gateway라는 심장 부품을 아예 통째로 재정비한 것입니다. 한마디로 요약하면 — 예전에는 OpenClaw 시작이 버스를 기다리는 것 같았다면, 지금은 신호등만 기다리듯 순식간에 켜집니다.

더 흥미로운 것은, 이번 업데이트 뒤에 '보이지 않는 근육'이 잔뜩 숨어 있다는 점입니다. 시작 가속부터 Subagent 컨텍스트 경량화, Discord 음성 회의를 데이터 소스로 끌어들이는 것까지, 전부 일상 경험을 파고든 진짜 작업들입니다. 지금부터 하나씩 뜯어보면서, 오늘 당장 써야 할 것들이 무엇인지 살펴보겠습니다.

Gateway는 이번에 대체 얼마나 빨래졌나

일러스트

오래된 사용자라면 압니다. Gateway는 OpenClaw의 총 밸브입니다 — 모든 Agent 호출, 모델 라우팅, Channel 메시지, Skill 로딩이 전부 이 문을 통과해야 합니다. 예전의 이 문에는 고질병이 있었습니다: 시작할 때마다, 설정을 새로고침할 때마다, 새 플러그인을 받을 때마다 디스크 전체를 뒤져 모든 Channel, Plugin, Manifest를 다시 훑어야 해서, 디스크 IO가 하드디스크 울음소리가 들릴 정도였습니다.

5.22는 이 로직을 그대로 '스냅샷 캐시' 방식으로 바꿔 버렸습니다:

  • Plugin metadata: 매번 시작할 때 모든 파일을 다시 stat하던 방식에서 프로세스 단위 immutable snapshot 재사용으로 변경되어, 시작 시 설정/모델/Channel 읽기가 곧장 메모리로 처리됩니다
  • Plugin SDK 별칭: 캐시된 alias map으로 중복 파일 순회를 건너뜁니다
  • 시작 시 유휴 작업: Lazy-load가 필요할 때 트리거되고, Gateway health/ready가 빈 handler 트리를 더는 기다리지 않습니다
  • ACPX 프로브: 지연 로딩으로 바뀌어, 쓰지 않으면 실행하지 않습니다
  • macOS Linuxbrew PATH: 관련 없는 탐색을 건너뛰어 시작 시 수백 밀리초의 stat 비용을 줄입니다

공식 테스트 기준, Channel catalog처럼 '같은 설정을 반복해서 읽는' 핫패스에서는 단일 호출이 밀리초급에서 마이크로초급으로 바로 내려갔고,일부 시나리오에서는 무려 4100배의 속도 향상을 기록했습니다. 이건 PR 제목용 과장이 아니라, IO를 메모리 히트로 바꿔낸 실질적인 물리학의 승리입니다.

Meeting Notes: 회의를 Agent의 입력 소스로

일러스트

이번에는 깊숙이 숨겨진 이스터에그도 하나 있습니다 — Meeting Notes 플러그인입니다.

메인 패키지에 포함되지 않은 독립 소스 플러그인으로, 별도 설치가 필요합니다. 하는 일은 하나입니다: '회의'라는 행위를 구조화된 데이터로 바꿔 당신의 Agent에게 먹이는 것입니다.

두 가지 모드를 지원합니다:

  • 자동 캡처: 회의 중 자동으로 녹음하고 자동으로 전사합니다
  • 수동 가져오기: transcript를 붙여넣는 것도 가능합니다

첫 번째 네이티브 지원 live source는 Discord 음성입니다. 즉, Discord에서 음성 회의를 열면 OpenClaw가 회의 내용을 실시간으로 노트로 바꾸고, Agent는 회의 내용을 바탕으로 바로 질문에 답하고, 요약을 생성하고, 액션 아이템을 추적할 수 있습니다.

CLI에서는 이렇게 조회할 수 있습니다:

openclaw meeting-notes list
openclaw meeting-notes get <id>

읽기 전용 접근이며, 쓰기는 플러그인이 자체 관리한다는 점에 유의하세요. 이 설계는 상당히 절제되어 있습니다 — 원본 데이터를 함부로 수정하지 못하게 하면서도, 언제든 Agent로 이를 활용하게 해줍니다.

Subagent가 드디어 '말을 아끼게' 됐습니다

일러스트

오래 쓴 사용자라면 절실히 압니다: 예전에는 Subagent를 호출해 일을 시키면 주 Agent의 SOUL.md, IDENTITY.md, USER.md, MEMORY.md, HEARTBEAT.md……가 전부 묶여서 전달됐습니다. 결과는 자식 Agent의 컨텍스트 폭발이었고, 자주 '저는 일하는 말입니다' 같은 엉뚱한 말을 하곤 했습니다.

5.22에서 기본 동작이 바뀌었습니다:Subagent bootstrap은 AGENTS.md와 TOOLS.md만 포함합니다.

페르소나, 신원, 사용자 프로필, 기억, 하트비트, 초기화 파일 — 이 모든 것이 더는 기본으로 내려가지 않습니다. 자식 Agent가 받는 것은 순수한 작업 컨텍스트이며, 일만 하면 됩니다.

이것이 의미하는 바:

  • 토큰 소비 절감 (직접 테스트 결과 같은 작업에서 30%~50% 절약)
  • 더 이상 캐릭터가 섞이지 않음 (각 Subagent가 더는 '일하는 말'이라고 자칭하지 않음)
  • 멀티 Agent 협업이 더 깔끔해짐

주 Agent의 특정 컨텍스트가 실제로 필요하다면 명시적으로 전달해야 합니다 — 이것은 보안 업그레이드이자 성능 업그레이드입니다.

미디어 이해: Gemini CLI가 더는 헤매지 않는다

일러스트

5.22에서 미디어 인식 fallback 체인이 바뀌었습니다.

예전의 OpenClaw는 이미지나 비디오를 보면 먼저 Gemini CLI로 돌릴 수 있는지 탐색했습니다. 이제는 탐색하지 않고 구성해 둔 공식 provider API를 직접 사용하며, Antigravity CLI는 '최후의 fallback'으로만 남습니다.

정리하면:

  • OpenAI / Anthropic / Zhipu / MiniMax의 이미지·비디오 이해 API를 구성해 뒀다면 → 바로 사용
  • 아무것도 구성하지 않았다면 → 그때 Antigravity CLI가 마지막을 맡습니다

이것은 흔한 함정을 피해 줍니다: 분명 메인 provider를 구성했는데 이유 없이 Gemini CLI로 빠져 권한 오류가 나는 상황 말입니다.

패키지 경량화: npm tarball에서 문서 이미지 제거

@openclaw/openclaw 이번 npm 패키지는 문서 이미지와 정적 리소스를 tarball에서 전부 제외했습니다.

최종 사용자 입장에서는:

  • npm install이 더 빨라짐
  • node_modules가 더 작아짐 (일부 사용자 실측에서 수십 MB 절감)
  • 런타임 문서 검색과 CLI 동작에는 영향 없음

이런 세부 최적화가 늘어나는 걸 보면, 팀이 엔지니어링 품질을 진지하게 다루고 있음을 알 수 있습니다.

대량의 문서 패치

이번 문서 쪽 업데이트는 폭죽 터뜨리듯 쏟아졌습니다. 핵심을 정리하면:

  • WhatsApp QR / 408 복구: QR 스캔에 실패하던 분들에게 희소식입니다
  • Cron 출력 언어 힌트: 예약 작업에서 언어를 지정할 수 있습니다
  • Gateway 업스트림 403 troubleshooting: 리버스 프록시에 의심받고 있다면 당황하지 마세요
  • GLM을 Z.AI 명명으로 통일: Zhipu의 모델이 더 이상 혼란스럽지 않습니다
  • Upstash Box 설치 가이드: 새로 추가된 배포 대상
  • Codex 마이그레이션 사전 조건: Codex에서 갈아타는 분들을 위한 완전한 가이드
  • Bitwarden SecretRef 설정: 시크릿 관리가 더 안전해짐
  • EasyRunner 배포 문서: 명령 한 줄로 Gateway를 띄우는 방법
  • 중국어 메모리 관리 가이드: 중국어 사용자에게 희소식

특히 언급할 만한 것:MEDIA 명령 규격이번에 명확하게 문서화됐습니다. 앞으로 MEDIA: 형식으로 이미지와 음성을 보내면, Channel 간 동작이 더 예측 가능해집니다.

실무자를 위한 실전 조언

오늘 당장 업그레이드할 거라면 이 점들을 기억하세요:

업그레이드 명령:

npm install -g @openclaw/openclaw@latest
openclaw gateway restart

시작이 빨라졌는지 검증:

time openclaw gateway status

업그레이드 전후 시작 시간을 비교해 보세요. 눈에 띄게 차이가 납니다.

Subagent 동작 점검: 예전에 Subagent가 MEMORY.md나 SOUL.md를 자동으로 가져오던 것에 의존했다면, 호출 시 명시적으로 전달해야 합니다. 그렇지 않으면 자식 Agent가 기억을 잃습니다.

Meeting Notes 설치:

openclaw plugin add meeting-notes

그다음 Discord 음성 소스를 구성하면 바로 사용할 수 있습니다.

이번 업데이트가 주목할 가치가 있는 이유

OpenClaw의 최근 한두 달 업데이트 페이스는 매우 공격적이지만, 5.22의 핵심 신호는:팀이 저수준 성능과 경험 디테일을 파고들기 시작했다는 점이며, 단순히 새 기능만 쌓는 것이 아니라는 것입니다.

Gateway 4100배 속도 향상이라는 수치는 과장처럼 들리지만, 해결하는 것은 사용자가 일상에서 가장 괴로워하는 '느린 시작, 끊김' 문제입니다. Subagent 컨텍스트 경량화는 'AI 캐릭터 혼동, 토큰 낭비' 문제를 해결합니다. Meeting Notes는 AI Agent를 '수동적 응답'에서 '현실 데이터의 능동적 소비'로 나아가게 하는 새로운 시도입니다.

하나하나 따로 보면 크지 않지만, 합치면 경험의 도약입니다.

아직 OpenClaw로 갈아탈지 망설이고 있다면, 5.22는 아주 좋은 진입 버전입니다. 이미 쓰고 있다면 업그레이드하세요. 안 할 이유가 없습니다.