[공식문서읽기] OpenClaw - README.md 읽기

 

OpenClaw는 자신의 기기에서 직접 실행하는 개인용 AI 어시스턴트입니다. WhatsApp, Telegram, Slack, Discord, iMessage 등 다양한 메시징 플랫폼과 연동되며, 로컬 퍼스트 아키텍처로 데이터 프라이버시를 보장합니다. MIT 라이선스로 완전 무료 오픈소스입니다.

---

OpenClaw란?

OpenClaw는 오스트리아 개발자 Peter Steinberger가 2025년 11월에 처음 공개한 프로젝트입니다. 원래 이름은 Clawdbot이었으나, Anthropic의 상표권 문제로 Moltbot을 거쳐 현재의 OpenClaw로 이름이 변경되었습니다.

전통적인 AI 어시스턴트가 프롬프트를 기다리는 것과 달리, OpenClaw는 상시 가동(always-on) 방식으로 이메일 관리, 웹 브라우저 제어, 일정 관리 등의 워크플로우를 자율적으로 수행합니다.

주요 특징

특징	설명
로컬 퍼스트	모든 데이터가 사용자 기기에 저장
멀티 채널	10개 이상의 메시징 플랫폼 지원
자율 실행	상시 모니터링 및 자동 작업 수행
오픈소스	MIT 라이선스, 완전 무료

2026년 2월 기준으로 GitHub 스타 216,000개 이상, 150만 개 이상의 에이전트가 배포되어 활발하게 사용되고 있습니다.

---

아키텍처

OpenClaw는 3계층 설계(Three-Layer Design)를 따릅니다.

1. Gateway Layer (세션 관리 허브)

WebSocket 기반 제어 평면으로 ws://127.0.0.1:18789에서 실행됩니다.

• 사용자 세션의 전체 라이프사이클 관리
• 메시지 큐잉 및 스케줄링
• 인증 및 권한 제어
• WebSocket 영구 연결 유지

2. Channel Layer (플랫폼 어댑터)

각 메시징 플랫폼의 메시지 포맷을 통일된 형태로 변환합니다.

지원 플랫폼:

• WhatsApp, Telegram, Signal
• Slack, Discord, Microsoft Teams
• iMessage (BlueBubbles), Google Chat
• Matrix, Zalo, WebChat

3. LLM Layer (모델 인터페이스)

통합 Provider 인터페이스와 MCP 서버를 연동합니다.

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  }
}

권장 모델은 Claude Opus 4.6으로, 긴 컨텍스트 성능과 프롬프트 인젝션 저항성이 우수합니다.

---

주요 기능

음성 기능 (Voice Wake & Talk Mode)

macOS, iOS, Android에서 ElevenLabs를 활용한 음성 감지 및 대화 모드를 지원합니다. 항상 음성을 듣고 있다가 명령에 반응합니다.

Live Canvas & A2UI

Canvas는 에이전트가 제어하는 시각적 워크스페이스입니다.

• HTML/CSS/JS 기반 경량 UI 렌더링
• 차트, 다이어그램 실시간 생성
• 포트 18793에서 별도 프로세스로 실행
• Gateway와 분리되어 안정성 확보

A2UI(Agent-to-UI)는 에이전트가 직접 UI를 구동하는 인터페이스로, 텍스트를 넘어선 시각적 상호작용을 가능하게 합니다.

MCP 도구 통합

OpenClaw는 @modelcontextprotocol/sdk를 네이티브로 지원합니다.

# MCP 서버 설정 예시
OPENCLAW_GATEWAY_URL=ws://localhost:18789
OPENCLAW_AGENT=default
OPENCLAW_TOKEN=your-token

주요 MCP 서버:

• server-filesystem: 파일 작업
• server-github: GitHub API 연동
• server-postgres: PostgreSQL 쿼리
• server-slack: Slack 워크스페이스 관리

1,000개 이상의 커뮤니티 빌트 MCP 서버가 사용 가능합니다.

Skills & ClawHub

Tools는 OpenClaw가 "무엇을 할 수 있는지"를 결정하는 기관입니다:

• read/write: 파일 접근
• exec: 시스템 명령 실행
• web_search: 웹 검색
• browser: 웹 페이지 상호작용

Skills는 Tools를 조합해 작업을 수행하는 방법을 가르치는 교과서입니다.

ClawHub는 공개 스킬 레지스트리로, 2026년 2월 기준 5,705개 이상의 커뮤니티 스킬이 등록되어 있습니다.

---

설치 방법

요구사항

• Node.js: 버전 22 이상
• 운영체제: macOS, Linux, Windows (WSL2)

빠른 설치

npm install -g openclaw@latest
openclaw onboard --install-daemon

onboard 명령은 대화형 마법사를 실행하여 Gateway 데몬을 설정합니다. 시스템 재시작 후에도 자동으로 실행됩니다.

소스에서 설치 (개발용)

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm openclaw onboard --install-daemon
pnpm gateway:watch  # 변경 시 자동 리로드

---

기본 사용법

CLI 명령어

명령어	설명
openclaw onboard	대화형 초기 설정
openclaw gateway	Gateway 실행
openclaw agent	에이전트와 상호작용
openclaw message send	메시지 전송
openclaw update --channel stable	업데이트 채널 변경

채팅 명령어

메시징 플랫폼에서 사용 가능한 명령어:

• /status: 현재 상태 확인
• /new: 새 세션 시작
• /think [level]: 사고 수준 조절
• /verbose on|off: 상세 출력 토글

/usage: 사용량 확인

---

시작하기

1. Node.js 22 이상 설치
2. npm install -g openclaw@latest 실행
3. openclaw onboard --install-daemon으로 설정

로컬에서 실행되는 AI 어시스턴트를 원한다면 OpenClaw를 시도해 보세요.

---

참고 자료

• OpenClaw GitHub 저장소
• OpenClaw 공식 문서
• OpenClaw 공식 웹사이트
• ClawHub 스킬 레지스트리
• OpenClaw Wikipedia
• OpenClaw 아키텍처 설명 - Substack

 

마무리

• OpenClaw는 로컬 퍼스트 아키텍처와 멀티 채널 지원으로 진정한 의미의 개인용 AI 어시스턴트를 구현합니다. 오픈소스이므로 누구나 자유롭게 사용하고 확장할 수 있습니다.
• 2026년 2월, OpenAI가 OpenClaw 창시자 Peter Steinberger를 영입하여 차세대 자율 AI 에이전트 개발을 이끌게 되었습니다. OpenClaw는 MIT 라이선스를 유지하며 오픈소스로 계속 운영될 예정입니다.
• OpenClaw는 이메일, 캘린더, 메시징 플랫폼 등에 광범위한 권한을 필요로 합니다. 잘못 구성된 인스턴스는 보안 및 프라이버시 위험을 초래할 수 있습니다. ClawHub에서 악성 스킬이 발견된 사례가 있어 VirusTotal과 파트너십을 맺고 스캔을 진행하고 있습니다.