OpenClaw 2.0 설명: 기능, 설치 가이드 & 업그레이드 위험

요약: OpenClaw 2.0(버전 태그 v2026.8.1, 2026년 8월 30일 늦은 시각/8월 31일 이른 시각 출시)은 오픈소스 AI 에이전트 OpenClaw 역사상 최대 규모의 업데이트입니다.

569명의 첫 기여자를 포함한 933명의 기여자가 16,000개 이상의 풀 리퀘스트를 병합했으며, 이는 프로젝트 전체 병합 PR의 절반가량에 해당합니다. 이번 릴리스는 온보딩을 단순화하고, 브라우저 Control UI를 대화 중심 경험으로 재구축했으며, 멀티플레이어 공유 클라우드 세션을 도입하고, 메모리를 통합하며, 스킬과 보안 제어를 개선하는 등 거의 모든 하위 시스템에 변화를 주었습니다.

설치는 기 보유 중인 ChatGPT/Claude 구독, API 키, 로컬 모델을 안내 기반으로 자동 탐지하여 극적으로 쉬워졌습니다. 업그레이드에는 현실적인 위험이 있으나 관리 가능합니다(SQLite 세션 마이그레이션, 플러그인 제거, 모델 라우트 이름 변경). 프로덕션 또는 멀티 모델 유연성을 위해, CometAPI 같은 통합 게이트웨이(한 개 키로 500+ 모델, 경쟁력 있는 요금)를 OpenClaw와 함께 사용하는 것이 실용적인 권장사항입니다.

핵심 요약

OpenClaw 2.0은 전통적 의미의 시맨틱 버전 도약이 아니라, 약 7주간의 집중 작업과 그 이전 230일 동안의 106차례 릴리스 이후 나온 대규모 통합 릴리스에 붙인 “2.0” 레이블입니다.
핵심 진전: 거의 무설정 첫 실행 설정, 세션 레일과 위젯을 갖춘 대화 중심 브라우저 앱, 공유 클라우드 세션(“멀티플레이어”), 백그라운드 통합과 자기학습을 포함한 내장 메모리, Skill Workshop, 더 강력해진(하지만 기본 하드닝은 아님) 권한 및 자격 증명 모델.
설치는 공식 스크립트를 통한 방법이 가장 간단(curl ... | bash 또는 PowerShell 동등 명령); Windows 및 macOS용 데스크톱 동반 앱이 제공됩니다.
업그레이드에는 검증된 백업이 필요합니다. 세 가지 주요 마이그레이션(SQLite 세션, OpenProse 제거, codex/* → openai/*)은 대부분 openclaw doctor --fix가 처리합니다. 초기 사후 릴리스 이슈는 비대화형 doctor 실행에 집중되었습니다.
보안은 여전히 운영자 책임입니다: 공유 세션은 협업 제어이지 테넌트 격리가 아니며, Secret Store는 기본적으로 저장 시 암호화되지 않고, 샌드박싱도 기본 비활성입니다. 비평가들은 이러한 공백을 지적했습니다.
모델 유연성, 비용 통제, 중복성 확보를 위해, OpenClaw를 CometAPI로 설정하여 커스텀 프로바이더로 사용하는 것이 권장됩니다(하나의 키로 OpenAI-compatible, Anthropic-messages, Google 포맷 지원).

OpenClaw란 무엇인가?

OpenClaw는 무료이자 오픈소스(MIT 라이선스)인 셀프 호스티드 자율형 AI 에이전트/개인 비서로, 주로 사용자의 하드웨어(macOS, Linux, Windows, Windows는 WSL2 권장)에서 실행됩니다. 브라우저 탭에서 제안만 하는 순수 챗봇(ChatGPT 등)과 달리, OpenClaw는 실제 작업을 수행합니다: 파일 관리, 브라우저 제어, WhatsApp/Telegram/Slack/Discord/Signal/iMessage 등 다양한 채널로 메시지 전송, 워크플로 자동화, 지속 메모리 유지 등.

이 프로젝트는 2025년 말(초기에는 Warelay/관련 프로젝트) Peter Steinberger와 커뮤니티에 의해 시작되어 리브랜딩 및 오픈소스로 공개되었고, 현재 OpenClaw Foundation이 관리합니다. 아키텍처는 로컬 Gateway(세션/툴/이벤트/채널을 위한 컨트롤 플레인), Control UI/CLI/TUI, 메시징 채널 플러그인, 옵션인 동반 앱을 중심으로 합니다. 모델은 호스팅(OpenAI, Anthropic, Google 등), 구독 기반, 또는 완전 로컬(Ollama, LM Studio, llama.cpp)로 사용할 수 있습니다. 상태와 자격 증명은 사용자 통제하에 유지됩니다.

2026년 중반까지 프로젝트는 약 230일 동안 106차례 릴리스를 내는 빠른 속도를 보였고, 이후 기초 작업을 통합하기 위해 약 7주간의 휴지기를 가졌습니다. 그 결과물이 OpenClaw 2.0입니다.

OpenClaw 2.0의 주요 기능

간소화된 안내형 설치 및 온보딩

첫 설정은 이제 머신에 이미 존재하는 리소스를 탐지합니다: 기존 ChatGPT, Claude, 또는 Codex 로그인/구독, API 키, 그리고 적합한 로컬 모델(Ollama, LM Studio). 설치 프로그램은 자격 증명을 저장하기 전에 선택한 모델이 실제로 요청을 완료할 수 있는지 검증한 다음, 남은 대부분의 설정을 초기 마법사 밖으로 이동시킵니다. 사용자는 더 빠르게 첫 대화에 도달하고, 나머지 설정은 에이전트와의 대화로 마무리합니다.

기본 OpenAI 지향 설정은 최신 모델을 선호하는 경향이 있습니다(일부 커버리지에서 GPT-5.6 기본값 언급); 로컬 경로도 개선되었습니다(예: 이전 node-llama-cpp 경로 대신 호스티드 llama-server, 더 높은 기본 컨텍스트 길이).

재구축된 브라우저 Control UI(대화 우선 경험)

브라우저 앱이 일급 표면으로 재구축되었습니다. 앱은 곧바로 대화로 시작합니다. 기존 Overview 페이지는 제거되었고, 세션이 사이드바에 위치합니다. 파일, 승인, 터미널, git diff, 도킹 가능한 브라우저 패널이 채팅 옆에 배치됩니다. “Session Rail”은 진행 상황, 평점, 계획 단계, pull request 등 콤팩트한 실시간 상태를 제공합니다. 대화형 위젯은 세션 대시보드에 고정할 수 있고, 범위가 제한된 동작이나 네트워크 출처를 부여받으며, 내보내기가 가능합니다. 시뮬레이션 환경에서의 성능 주장은 JavaScript 요청 감소(140 → 45)와 더 빠른 시작 시간(약 1.6초 → 약 575ms)을 포함합니다.

공유 클라우드 세션(“Multiplayer”)

협업의 대표 기능입니다: 다수 사용자가 동일한 진행 중인 에이전트 세션에 전체 컨텍스트로 참여하여 작업을 할당하고, 변경을 제안하며, 드래프트 모드로 작업하거나 완전 참여할 수 있습니다. 접근 레벨은 소유자/관리자가 제어할 수 있습니다. OpenClaw 팀 자체도 이제 이 모드로 OpenClaw를 개발합니다. 세션은 로컬 Gateway, 페어링된 디바이스(openclaw connect), 또는 프로비저닝 도구(AWS, Hetzner 등)를 통한 임시 클라우드 머신에서 실행될 수 있습니다. 프로젝트가 강조한 중요한 주의점: 이는 협업 제어이며, 적대적 테넌트 격리나 네트워크/파일 시스템 보안 경계가 아닙니다.

메모리 시스템 통합

내장 Memory가 이제 핵심 검색과 리콜을 담당합니다(QMD 애드온은 지원 마이그레이션을 통해 퇴역). 백그라운드 통합(“grounded dreaming”)은 출처가 보증된 자료를 장기 메모리로 승격합니다(“Dream Diary”와 명시적 끔 스위치 제공). 자기학습은 재사용 가치가 높은 강력한 교훈을 제안 스킬로 전환할 수 있습니다. 전체 텍스트 대화 검색이 가능하며, openclaw memory forget 같은 명시적 제어도 제공됩니다. 기본적으로 세션은 유휴 기간과 날짜 경계를 넘어 더 내구성 있게 지속됩니다.

스킬, 자동화, 위젯

Skill Workshop은 스킬 생성, 검증, 설치, 호출, 검토를 위한 안내 경로를 제공합니다. 적용 이력과 함께, 카탈로그 전체 깨짐 대신 개별적으로 무효 스킬을 보고합니다. 자동화는 생성한 대화와 연결된 상태를 유지할 수 있고, 반복 작업은 일회성 승인을 사용할 수 있습니다. IMAP 플러그인은 수신 이메일로부터 에이전트 작업을 트리거할 수 있습니다. 대화형 위젯과 내구성 있는 진행 카드가 UI를 진정한 컨트롤 표면으로 전환합니다.

보안 및 권한 모델 개선

승인은 이제 정확한 요청, 명령, 세션, 사람에 더 엄격히 바인딩됩니다. 재사용 가능한 명령 권한은 정확한 인자와 작업 디렉터리에 바인딩될 수 있으며, 스크립트 기반 명령은 검토된 바이트를 재검사합니다. 세션은 읽기 전용, 가드드, 워크스페이스, 전체 접근 같은 명시적 모드를 지원합니다. 팀 자격 증명 저장소는 특정 비밀 값을 쓰기 전용으로 유지하고, 에이전트는 모델에 보이는 텍스트로 들어가지 않는 마스킹된 프롬프트를 통해 자격 증명을 요청할 수 있습니다. 임의의 실행 가능한 소스에서 플러그인을 설치하려면 명시적 강제 플래그가 필요합니다. 이는 이전 보안 권고 이후 의미 있는 조치이지만, 남아 있는 공백은(리스크 섹션에 상세) 비평가들이 지적합니다.

기타 주목할 변화

모델 및 프로바이더 확장과 라우트 정리
네이티브 앱과 동반 앱 업데이트
새로운 세션 모델을 지원하는 스토리지 백엔드 변경
채널과 도구 전반의 광범위한 버그 수정 및 안정성 개선

OpenClaw 2.0 설치 방법

시스템 요구 사항

Node.js 22.22.3+, 24.15+, 또는 25.9+ (Node 26 권장; 설치 스크립트가 적합한 버전을 제공하는 경우가 많음)
macOS, Linux, 또는 Windows(Windows에서는 Gateway에 WSL2 강력 권장)
선택 사항: 소스에서 빌드 시 pnpm

데스크톱 동반 앱:

Windows Hub(x64/arm64 서명된 설치 프로그램)
macOS 메뉴 막대 앱(GitHub 릴리스에서 DMG/ZIP)

권장: 공식 설치 스크립트

macOS / Linux / WSL2:

curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell):

iwr -useb https://openclaw.ai/install.ps1 | iex

이 스크립트는 OS를 감지하고, 필요 시 Node를 설치하며, OpenClaw를 설치하고 온보딩을 시작합니다. --no-onboard 등 자동화를 위한 플래그가 존재합니다.

대체 방법

npm(Node가 이미 관리되는 경우):

  npm install -g openclaw@latest --allow-scripts=openclaw   # adjust for older npm
  openclaw onboard --install-daemon

적절한 trust/allow-build 플래그를 사용하는 pnpm 또는 bun 동등 명령
소스에서(기여자):

  git clone https://github.com/openclaw/openclaw.git
  cd openclaw
  corepack enable
  pnpm install && pnpm build && pnpm ui:build
  pnpm add --global "openclaw@link:$PWD"
  openclaw onboard --install-daemon

로컬 프리픽스 설치자와 컨테이너/VPS 옵션은 고급 배포용으로 문서화되어 있습니다.

설치 후 검증

openclaw --version
openclaw doctor
openclaw gateway status
openclaw dashboard   # or open http://127.0.0.1:18789/ on the gateway host

관리되는 시작은 LaunchAgents(macOS), systemd 사용자 서비스(Linux/WSL2), 또는 Scheduled Tasks(네이티브 Windows)를 사용합니다. 전체 세부 사항은 공식 설치 문서에 있습니다.

업그레이드 경로와 리스크

업그레이드 전 체크리스트

OpenClaw 상태 디렉터리, 구성, 세션, 커스텀 플러그인/스킬의 검증된 백업을 생성합니다.
공식 릴리스 노트(docs.openclaw.ai/releases/2026.8.1)와 업데이트 가이드를 검토합니다.
업그레이드와 doctor 단계는 인터랙티브 터미널(TTY)에서 수행하는 것을 선호하십시오—초기 보고에 따르면 비대화형 doctor --fix가 2.0 마이그레이션을 조용히 건너뛰는 경우가 있었습니다.

알려진 마이그레이션과 브레이킹 변경

변경 사항	영향 및 조치
세션 및 전사본 → SQLite	마이그레이션 이후 생성된 새 세션은 다운그레이드 시 이전 릴리스에서 보이지 않습니다. 먼저 백업하십시오.
번들 OpenProse 플러그인 및 /prose 명령 제거	openclaw doctor --fix를 실행하고, 업스트림 Agent Skill 마이그레이션을 따르십시오. 기존 .prose 파일은 유지됩니다.
codex/* 및 openai-codex/* 모델 참조 → openai/*	openclaw doctor --fix가 라우트, 프로바이더 구성, 저장된 세션, 자동화를 마이그레이션합니다. 충돌은 수동 수리가 표시됩니다.
Plugin SDK 서브패스 폐기	2026년 9월 1일 게이트; SDK 마이그레이션 가이드에 따라 플러그인을 업데이트하십시오.

대부분의 정리는 openclaw doctor --fix(또는 --repair)가 처리합니다. 업그레이드 후 세션별 권한 모드를 재평가(최소 권한 선호)하고, 이전 권고의 하드닝 체크리스트를 다시 적용하십시오.

초기 사후 릴리스 이슈(8월 31일 늦은 시각 기준 보도)

TTY 없이 doctor --fix가 마이그레이션을 건너뛰는 문제(P1, 빠르게 수정 보고)
특정 임베딩 프로바이더에서의 메모리 동기화 이슈(예: Gemini 배치 제한)
레거시 설치에서 플러그인 동의 지속성
대시보드 준비 상태 오탐

이 정도 규모의 릴리스는 후속 패치를 동반하는 것이 일반적입니다. 공식 트래커와 릴리스 노트를 모니터링하십시오.

보도에서 강조된 보안 리스크

The Register 등은 사용성이 극적으로 개선되었지만, “기본 보안”이 완전히 동반되지는 않았다고 지적했습니다:

공유 세션 제어는 네트워크 또는 파일 시스템 수준의 격리/테넌트 경계가 아닙니다.
Secret Store 값(비밀번호, API 키)은 저장 시 암호화되지 않습니다. 상태 디렉터리의 파일 시스템 권한에 의존합니다.
신뢰할 수 없는 코드를 격리하는 샌드박스는 기본적으로 비활성입니다.

2026년(2.0 이전) 분석은 이미 평문 자격 증명, 파괴적 작업으로 이어지는 프롬프트 인젝션, 심각한 CVE, 스킬 마켓플레이스(ClawHub)의 공급망 우려를 문서화했습니다. 2.0은 승인 바인딩과 권한 모드를 강화했지만, 최소 권한 구성, 네트워크 격리, 비밀 관리, 샌드박스 활성화는 여전히 운영자 책임입니다. 강력한 에이전트에 광범위한 시스템과 자격 증명 접근을 부여하는 일은 결코 가볍게 이루어져서는 안 됩니다.

비교 표: OpenClaw Pre-2.0 vs OpenClaw 2.0

항목	Pre-2.0(2026년 중반 기준 전형)	OpenClaw 2.0(v2026.8.1)
설치	초기 실행 시 구성 비중이 높음	기존 키/구독/로컬 모델의 안내 탐지; 대화 기반 완료
브라우저/Control UI	Overview 중심, 통합도 낮음	대화 우선, Session Rail, 위젯, 도킹 가능한 패널
협업	주로 단일 사용자/로컬	역할 기반 참여가 가능한 공유 클라우드 세션
메모리	분산/ QMD 애드온 일반적	내장 통합 + 백그라운드 통합 + 자기학습
스킬	다소 임기응변	Skill Workshop, 검증, 이력
세션 저장	이전 포맷	SQLite(마이그레이션 필요)
보안 모델	개선 중이나 정책 의존적	더 엄격한 승인 바인딩, 명시적 세션 모드, 쓰기 전용 시크릿(여전히 운영자 기본값 의존)
릴리스 규모	빈번한 소규모 배포	역사적 PR의 약 50%를 한 번에 담은 통합 릴리스

CometAPI로 OpenClaw 강화: 권장 통합

OpenClaw는 모델에 중립적입니다. 공식 프로바이더 키, 로컬 모델, 또는 통합 게이트웨이를 지정할 수 있습니다. 하나의 API 키로 500+ 모델(GPT 계열, Claude 계열, Gemini 등), 경쟁력 있는 가격(종종 리스트 대비 20%+ 낮음), 손쉬운 전환, 중앙화된 관측을 원하는 팀과 파워 유저에게는 CometAPI가 자연스러운 선택입니다. CometAPI는 하나의 자격 증명으로 OpenAI-compatible, Anthropic-messages, Google-generative-ai 엔드포인트를 제공합니다.

CometAPI로 OpenClaw를 구성하는 5분 튜토리얼

cometapi.com에서 CometAPI 키를 발급받습니다.
안전하게 저장합니다(예: ~/.openclaw/.env의 COMETAPI_KEY에 제한된 권한으로 저장하거나 선호하는 시크릿 매니저 사용).
~/.openclaw/openclaw.json(또는 동등 파일)을 편집하여 프로바이더를 추가합니다. 예:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "cometapi-claude/claude-sonnet-4-6"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "gpt-5.4", "name": "GPT-5.4" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "${COMETAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "${COMETAPI_KEY}",
        "api": "google-generative-ai",
        "models": [{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }]
      }
    }
  }
}

(정확한 모델 ID와 경로는 카탈로그가 변동되므로 최신 CometAPI 및 OpenClaw 문서를 확인하십시오.) 세션에서는 전체 provider/model 참조를 사용하십시오. 변경 후 Gateway를 재시작하고 테스트 대화로 확인합니다.

이 설정은 여러 벤더 계정을 재키잉하지 않고도 다양한 프런티어/비용 효율 모델을 실험할 수 있게 하며, OpenClaw의 셀프 호스티드 컨트롤 플레인은 그대로 유지합니다. 자세한 가이드는 CometAPI의 OpenClaw 통합 페이지에 있습니다.

실용적 권장 사항과 모범 사례

가장 빠른 유용한 에이전트 경로를 위해 안내형 설치와 재구축된 브라우저 UI로 시작하십시오.
공유 세션은 신뢰할 수 있는 참여자 간 협업 기능으로만 취급하십시오. 멀티 테넌시 우려가 있으면 네트워크와 호스트 격리를 추가로 계층화하십시오.
세션별로 가능한 가장 좁은 권한 모드를 활성화하고, 신뢰할 수 없는 스킬/코드에는 샌드박싱을 활성화하십시오.
주요 업그레이드 전에는 항상 백업하고, 2.0급 릴리스 이후에는 doctor를 대화형으로 실행하십시오.
멀티 모델 또는 비용 민감 워크로드에는 CometAPI 같은 게이트웨이를 통해 라우팅하여 여러 개별 키를 직접 관리하지 마십시오.
공식 릴리스 노트, GitHub 트래커, 보안 권고를 모니터링하십시오—OpenClaw는 빠른 속도로 기능과 수정이 함께 도착합니다.
프로젝트의 자체 프레이밍을 기억하십시오: OpenClaw는 오픈소스이며, 여러분이 소유하고 형태를 빚어갈 수 있습니다. 2.0 릴리스는 첫 유용한 워크플로까지의 장벽을 크게 낮추는 동시에, 팀과 연속 사용을 위한 상한선을 확장했습니다. 신중한 권한 위생과, 멀티 모델 유연성이 중요하다면 CometAPI 같은 통합 API 레이어를 결합하면, 실제 작업을 위한 강력하고 소유된 기반을 갖출 수 있습니다.

자주 묻는 질문(FAQs)

OpenClaw 2.0의 정확한 버전은 무엇인가요?

출시 태그는 v2026.8.1(8월 30일 늦은 시각/8월 31일 이른 시각)입니다. 전례 없는 규모 때문에 프로젝트와 커뮤니티는 이를 OpenClaw 2.0이라 부릅니다.

OpenClaw 2.0은 브레이킹 업그레이드인가요?

대부분 추가적이지만, 세 가지 의도된 마이그레이션(SQLite 세션, OpenProse 제거, 모델 라우트 이름 변경)에 주의가 필요합니다. openclaw doctor --fix가 제대로 실행되면 대부분을 처리합니다.

일반적인 설치 시간은 얼마나 걸리나요?

공식 스크립트와 기존 AI 접근이 이미 있는 경우, 많은 사용자가 몇 분 내에 첫 대화에 도달합니다. 전체 구성은 대화형으로 계속할 수 있습니다.

로컬 모델을 계속 사용할 수 있나요?

가능합니다. Ollama, LM Studio, 개선된 llama.cpp/llama-server 경로가 지원되며, 안내형 설정 중 탐지됩니다.

OpenClaw는 무료인가요?

소프트웨어는 MIT 라이선스로 무료입니다. 비용은 선택한 LLM 프로바이더(또는 로컬 컴퓨트)에서 발생합니다. CometAPI 같은 게이트웨이는 모델 비용을 낮출 수 있습니다.

공유 세션 기능을 기업이 즉시 사용해야 하나요?

상호 신뢰하는 참여자 간에만, 그리고 문서의 명시적 비격리 진술을 검토한 후에 사용하십시오. 호스트 수준과 네트워크 제어와 결합하십시오.

공식 릴리스 노트와 문서는 어디에 있나요?

주요 출처: openclaw.ai 블로그, docs.openclaw.ai(2026.8.1 릴리스 페이지와 설치/업데이트 가이드 포함), GitHub 저장소 github.com/openclaw/openclaw.

설치 후 모델이나 프로바이더를 어떻게 전환하나요?

구성을 편집(또는 에이전트와 대화로 설정 완료)하고, Gateway를 재시작한 뒤 검증하십시오. CometAPI 같은 커스텀 프로바이더는 models.providers 구조를 통해 깔끔하게 통합됩니다.

OpenClaw 2.0은 셀프 호스티드 에이전트 카테고리의 성숙점을 나타냅니다: 시작 마찰은 크게 낮추고, 연속성과 협업 기능은 풍부해졌으며, 보안 프리미티브는 보다 명확해졌습니다(여전히 운영자 주도). 지속적인 개인 에이전트를 원하는 개인이든, 멀티플레이어 에이전트 워크플로를 탐색하는 소규모 팀이든, 2.0 릴리스는 지금까지 제공된 최강의 출발점입니다. 신중한 권한 관리와, 멀티 모델 유연성이 중요할 경우 CometAPI 같은 통합 API 레이어를 결합하면, 실질적인 작업을 위한 강력하고 소유된 기반을 마련할 수 있습니다.

프로덕션 배포 전에는 항상 최신 공식 문서를 교차 확인하십시오. 프로젝트는 빠르게 진화하고 있습니다.