openclaw/openclaw View GitHub Homepage for Latest Official Releases

모든 OS에서 로컬로 실행되며 100개 이상의 메시징 플랫폼에 연결되고 자율적인 작업 실행 기능을 갖춘 오픈소스 개인 AI 비서

MITTypeScriptopenclawopenclaw 187.3k Last Updated: February 12, 2026

OpenClaw - 개인 AI 비서

개요

OpenClaw는 사용자가 자체 인프라에 개인 AI 비서를 배포할 수 있도록 지원하는 무료 오픈 소스 자율 AI 비서 프레임워크입니다. 원래 오스트리아 소프트웨어 엔지니어 Peter Steinberger가 2025년 11월 "Clawdbot"이라는 이름으로 개발했으며, 이후 프로젝트 이름이 "Moltbot"으로 변경되었다가 2026년 초에 최종적으로 "OpenClaw"로 명명되었습니다. GitHub에서 117,000개 이상의 별과 16,500개의 포크를 달성하며 상당한 인기를 얻었습니다.

프로젝트 링크

핵심 개념

OpenClaw는 단순히 프롬프트에 응답하는 것을 넘어 "실제로 일을 하는" AI 비서로서 차별화됩니다. 대규모 언어 모델(LLM)을 통해 독립적으로 작업을 실행할 수 있는 자율 에이전트로 작동하며, 메시징 플랫폼을 주요 사용자 인터페이스로 사용합니다.

주요 기능

1. 다중 플랫폼 통합

  • 다음을 포함한 100개 이상의 메시징 서비스에 연결:
    • WhatsApp (Baileys 경유)
    • Telegram (grammY 경유)
    • Slack (Bolt 경유)
    • Discord (discord.js 경유)
    • Google Chat
    • Signal
    • iMessage
    • Microsoft Teams
    • Matrix
    • BlueBubbles
    • WebChat
    • 및 기타 다수

2. 로컬 우선 게이트웨이 아키텍처

  • 세션, 채널, 도구 및 이벤트를 위한 단일 WebSocket 제어 평면
  • 자체 하드웨어(Mac mini, Linux 서버, WSL2를 통한 Windows)에서 전적으로 실행
  • 개인 정보 보호 중심: 모든 데이터는 자체 인프라에 유지
  • 핵심 기능에 대한 클라우드 종속성 없음

3. 다중 에이전트 라우팅

  • 수신 채널/계정을 격리된 에이전트로 라우팅
  • 에이전트별 세션을 통한 작업 공간 기반 구성
  • 여러 동시 AI 모델 및 공급자 지원

4. 음성 및 스피치 기능

  • 음성 웨이크: macOS/iOS/Android용 상시 음성 인식
  • 토크 모드: ElevenLabs 통합을 통한 연속 대화
  • 컴패니언 앱을 통한 푸시 투 토크 지원

5. 라이브 캔버스

  • 에이전트 기반 시각적 작업 공간
  • 동적 인터페이스를 위한 A2UI(Agent-to-UI) 프레임워크
  • 실시간 렌더링 및 상호 작용

6. 고급 도구 통합

  • 브라우저 제어: CDP를 통한 전용 Chrome/Chromium 자동화
  • 캔버스 작업: 푸시/재설정, 평가, 스냅샷 기능
  • 장치 노드: 카메라, 화면 녹화, 위치 서비스
  • 시스템 통합: 알림, 로컬 명령 실행
  • 자동화: Cron 작업, 웹훅, Gmail Pub/Sub 트리거

7. 스킬 플랫폼

  • 번들, 관리, 작업 공간 스킬을 갖춘 모듈식 스킬 시스템
  • 검색 및 설치를 위한 ClawdHub 스킬 레지스트리
  • 사용자 정의 스킬 개발 지원

8. 모델 유연성

여러 AI 공급자 지원:

  • Anthropic (Claude 모델 - Opus 4.5, Sonnet 4.5, Haiku 4.5)
  • OpenAI (GPT 모델, Codex)
  • Google (Gemini)
  • API를 통한 기타 LLM 공급자

아키텍처

핵심 구성 요소

게이트웨이

  • 중앙 WebSocket 서버 (기본값: ws://127.0.0.1:18789)
  • 세션, 상태, 구성 관리
  • 메시지 라우팅 및 전달 처리
  • 제어 UI 대시 제공

Pi 에이전트 런타임

  • RPC 기반 실행 엔진
  • 도구 스트리밍 및 블록 스트리밍
  • 컨텍스트 창 관리
  • 세션 격리

세션 모델

  • 직접 채팅을 위한 메인 세션
  • 활성화 모드를 통한 그룹 격리
  • 동시 요청을 위한 큐 관리
  • 회신 라우팅

보안 모델

기본 동작:

  • 호스트에서 메인 세션용 도구 실행 (인증된 사용자에게 전체 액세스 권한 부여)
  • 그룹/채널 세션을 위한 구성 가능한 샌드박스 모드
  • DM 페어링 시스템으로 무단 액세스 방지

샌드박스 옵션:

  • 메인 세션이 아닌 세션을 위한 세션별 Docker 컨테이너
  • 도구 허용/거부 목록
  • 네트워크 격리 기능

설치 및 배포

시스템 요구 사항

  • 런타임: Node.js ≥22
  • OS 지원: macOS, Linux, Windows (WSL2 경유)
  • 패키지 관리자: npm, pnpm 또는 bun

빠른 시작

# 전역 설치
npm install -g openclaw@latest

# 온보딩 마법사 실행
openclaw onboard --install-daemon

# 게이트웨이 시작
openclaw gateway --port 18789 --verbose

# 테스트 메시지 보내기
openclaw message send --to +1234567890 --message "Hello from OpenClaw"

# 에이전트와 상호 작용
openclaw agent --message "Ship checklist" --thinking high

소스에서 빌드

git clone https://github.com/openclaw/openclaw.git
cd openclaw

pnpm install
pnpm ui:build
pnpm build

pnpm openclaw onboard --install-daemon
pnpm gateway:watch  # 자동 새로고침을 통한 개발 모드

구성

최소 구성

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

채널 구성 예시

WhatsApp:

pnpm openclaw channels login

Telegram:

{
  "channels": {
    "telegram": {
      "botToken": "YOUR_BOT_TOKEN"
    }
  }
}

Discord:

{
  "channels": {
    "discord": {
      "token": "YOUR_DISCORD_TOKEN"
    }
  }
}

보안 및 개인 정보 보호

보안 기능

  • DM 페어링 시스템 (모르는 사람에게 페어링 코드 제공)
  • 허용 목록 기반 액세스 제어
  • 구성 가능한 샌드박스 환경
  • 신뢰할 수 없는 세션을 위한 선택적 Docker 격리
  • 안전한 원격 액세스를 위한 Tailscale 통합

개인 정보 보호 이점

  • 자체 호스팅: 완전한 데이터 소유권
  • 기본적으로 클라우드 원격 측정 없음
  • 로컬 자격 증명 저장
  • 구성 가능한 네트워크 제한

보안 고려 사항

보안 연구원에 따르면:

  • 효과적인 기능을 위해 광범위한 권한 필요
  • 보안 영향을 이해하는 고급 사용자에게 적합
  • 프로덕션 환경에서는 격리된 환경에서 실행하는 것이 좋습니다.
  • 확장 가능한 아키텍처로 인한 공급망 위험
  • 적절한 보안 조치 없이는 프로덕션 서비스에 연결해서는 안 됩니다.

원격 액세스

OpenClaw는 다음을 통해 원격 게이트웨이 액세스를 지원합니다.

  • Tailscale Serve/Funnel: 안전한 테일넷 또는 공개 HTTPS
  • SSH 터널: 전통적인 안전한 터널링
  • 토큰/비밀번호 인증: 구성 가능한 인증 모드

이를 통해 Linux 서버에서 게이트웨이를 실행하면서 모든 장치에서 제어할 수 있습니다.

채팅 명령

사용자는 명령을 사용하여 세션을 제어할 수 있습니다.

  • /status - 세션 정보
  • /new 또는 /reset - 대화 재설정
  • /compact - 컨텍스트 요약
  • /think <level> - 생각 깊이 조정
  • /verbose on|off - 자세한 출력 토글
  • /usage off|tokens|full - 사용량 통계
  • /restart - 게이트웨이 재시작 (소유자만 가능)
  • /activation mention|always - 그룹 설정

컴패니언 애플리케이션

macOS 앱

  • 게이트웨이 상태를 위한 메뉴 표시줄 제어
  • 음성 웨이크 및 푸시 투 토크
  • WebChat 인터페이스
  • 디버그 도구
  • 원격 게이트웨이 제어

iOS 노드

  • 음성 트리거 전달
  • 캔버스 표면 렌더링
  • 노드 기반 명령 실행

Android 노드

  • 캔버스, 카메라, 화면 캡처
  • 브리지를 통한 노드 페어링

에이전트 작업 공간 및 스킬

  • 작업 공간 루트: ~/.openclaw/workspace
  • 프롬프트 파일: AGENTS.md, SOUL.md, TOOLS.md
  • 스킬 디렉토리: ~/.openclaw/workspace/skills/

사용 사례

  1. 개인 생산성 비서

    • 이메일 관리 및 응답
    • 일정 조정
    • 작업 자동화

  2. 개발 자동화

    • GitHub 알림
    • 자동 배포
    • 코드 검토 지원

  3. 다중 채널 통신 허브

    • 플랫폼 간 통합 받은 편지함
    • 자동 응답
    • 메시지 전달 및 라우팅

  4. 사용자 정의 워크플로 자동화

    • 내부 도구와의 통합
    • 데이터 처리 파이프라인
    • 예약된 작업 및 알림

커뮤니티 및 개발

  • 활발한 개발: 8,368개 이상의 커밋
  • 오픈 소스: MIT 라이선스
  • 커뮤니티: Discord 서버 이용 가능
  • 기여: PR 및 커뮤니티 참여 환영
  • 문서: docs.openclaw.ai에서 종합적인 문서 제공

주목할 만한 성과

  • 117k개 이상의 GitHub 별
  • 16.5k개 이상의 포크
  • 위키백과에 소개됨
  • Moltbook 통합을 통한 바이럴 인기
  • 실리콘 밸리 및 국제 개발자들의 상당한 관심

대안과의 비교

ChatGPT 또는 Claude AI와 달리:

  • 자율적: 반응형 응답 대비 독립적으로 작업 실행
  • 자체 호스팅: 자체 인프라에서 실행
  • 다중 플랫폼: 100개 이상의 서비스와 네이티브 통합
  • 확장 가능: 사용자 정의 스킬 및 도구
  • 개인 정보 보호 우선: 완전한 데이터 제어

시작하기 리소스

  1. 공식 문서
  2. 시작하기 가이드
  3. 구성 참조
  4. 보안 가이드
  5. 문제 해결

향후 개발

OpenClaw는 다음을 통해 적극적으로 유지 관리됩니다.

  • 정기적인 업데이트 및 버그 수정
  • 새로운 채널 통합
  • 향상된 보안 기능
  • 확장된 AI 모델 지원
  • 성장하는 스킬 생태계

크레딧

  • 창작자: Peter Steinberger
  • 특별 감사: Mario Zechner (pi-mono), Adam Doppelt (lobster.bot)
  • 커뮤니티: 200명 이상의 기여자 및 증가 추세

결론

OpenClaw는 자율성, 개인 정보 보호 및 자체 호스팅을 강조하는 개인 AI 비서의 패러다임 전환을 나타냅니다. 기존 워크플로 및 통신 채널과의 통합 유연성을 유지하면서 AI 비서를 완전히 제어하려는 개발자 및 고급 사용자에게 이상적입니다.

자체 호스팅에 익숙하고 챗봇이 아닌 진정한 자율 에이전트로 작동하는 AI 비서를 찾는 사람들에게 OpenClaw는 강력한 오픈 소스 기반을 제공합니다.

Star History Chart