OpenClaw 가이드: 개인 AI 비서 설치부터 활용까지

OpenClaw란 무엇인가?

OpenClaw는 로컬 환경에서 실행되는 오픈소스 개인 AI 비서입니다. 2025년 11월에 Clawdbot이라는 이름으로 처음 출시되었고, 이후 Moltbot을 거쳐 현재 OpenClaw로 이름이 변경되었습니다.

오스트리아 개발자 Peter Steinberger가 만든 이 프로젝트는 출시 2개월 만에 GitHub에서 10만 스타를 돌파하며 역대 가장 빠르게 성장한 GitHub 저장소 중 하나가 되었습니다. 현재는 117,000개 이상의 스타를 보유하고 있습니다.

OpenClaw의 핵심 컨셉

OpenClaw의 가장 큰 특징은 "Your own personal AI assistant"라는 슬로건처럼, 클라우드가 아닌 사용자의 로컬 기기에서 직접 실행된다는 점입니다. 이는 데이터 프라이버시와 보안 측면에서 큰 장점을 제공합니다.

---

OpenClaw의 주요 특징

1. 다양한 메시징 플랫폼 통합

OpenClaw는 이미 사용 중인 메시징 앱과 연동되어 작동합니다:

• WhatsApp: Baileys 라이브러리 기반
• Telegram: grammY 프레임워크 사용
• Slack: Bolt 프레임워크 지원
• Discord: discord.js 기반
• Google Chat: Chat API 연동
• Signal: signal-cli 활용
• iMessage: macOS 전용
• Microsoft Teams: 확장 기능
• Matrix, BlueBubbles, Zalo: 추가 확장 채널

2. 로컬 실행 & 완전한 제어

• 모든 데이터가 로컬에 저장됨
• 외부 서버에 정보가 전송되지 않음
• 사용자가 완전한 통제권을 가짐

3. Model Context Protocol (MCP) 지원

OpenClaw는 MCP를 통해 100개 이상의 서드파티 서비스와 연결할 수 있습니다. 이를 통해 캘린더 관리, 이메일 전송, 리서치, 워크플로우 자동화 등 다양한 작업을 수행할 수 있습니다.

4. 음성 지원

macOS, iOS, Android에서 음성 인식 및 응답 기능을 지원합니다.

5. 브라우저 제어

전용 Chrome/Chromium 브라우저를 통해 웹 작업을 자동화할 수 있습니다.

---

시스템 요구사항

OpenClaw를 설치하기 전에 다음 요구사항을 확인하세요:

필수 요구사항

• Node.js 22 이상: 반드시 최신 LTS 버전 사용 권장
• 운영체제:
  • macOS (전체 기능 지원)
  • Linux (권장)
  • Windows (WSL2 사용 강력 권장)

권장 패키지 매니저

• pnpm (가장 권장)
• npm
• bun (TypeScript 직접 실행 시)

---

OpenClaw 설치 방법

OpenClaw 설치는 크게 두 가지 방법이 있습니다: npm을 통한 설치와 소스코드에서 빌드.

방법 1: npm을 통한 설치 (권장)

가장 간단하고 빠른 설치 방법입니다.

# npm 사용
npm install -g openclaw@latest

# 또는 pnpm 사용 (권장)
pnpm add -g openclaw@latest

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

온보딩 마법사는 게이트웨이 설정, 워크스페이스 구성, 채널 연결, 스킬 설정을 단계별로 안내해줍니다.

방법 2: 소스코드에서 빌드

개발자이거나 최신 개발 버전을 사용하고 싶다면 GitHub에서 직접 빌드할 수 있습니다.

# 저장소 클론
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 의존성 설치
pnpm install

# UI 빌드 (처음 실행 시 자동으로 UI 의존성 설치)
pnpm ui:build

# 프로젝트 빌드
pnpm build

# 온보딩 실행
pnpm openclaw onboard --install-daemon

# 개발 모드 실행 (TypeScript 변경 시 자동 리로드)
pnpm gateway:watch

Docker를 통한 설치

보안을 더욱 강화하고 싶거나 격리된 환경에서 실행하고 싶다면 Docker를 사용할 수 있습니다.

# Docker Compose 사용
docker-compose up -d

---

기본 사용법

1. 게이트웨이 실행

OpenClaw의 핵심은 "게이트웨이"입니다. 게이트웨이는 모든 메시징 채널과 AI 모델을 연결하는 중앙 제어 장치입니다.

# 게이트웨이 시작 (포트 18789에서 실행)
openclaw gateway --port 18789 --verbose

2. 메시지 전송

터미널에서 직접 메시지를 전송할 수 있습니다.

openclaw message send --to +1234567890 --message "안녕하세요, OpenClaw입니다"

3. AI 에이전트와 대화

openclaw agent --message "오늘 할 일 목록 작성해줘" --thinking high

4. 채팅 명령어

메시징 앱에서 다음 명령어를 사용할 수 있습니다:

• /status: 현재 세션 상태 확인
• /new 또는 /reset: 세션 초기화
• /compact: 세션 컨텍스트 압축
• /think <level>: 사고 수준 설정 (off/minimal/low/medium/high/xhigh)
• /verbose on|off: 상세 모드 전환
• /usage off|tokens|full: 토큰 사용량 표시 설정

---

지원하는 메시징 플랫폼

WhatsApp 연동

# WhatsApp 로그인
pnpm openclaw channels login

자격 증명은 ~/.openclaw/credentials에 저장됩니다.

설정 파일 (~/.openclaw/openclaw.json):

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+821012345678"],
      "groups": ["*"]
    }
  }
}

Telegram 연동

환경 변수 또는 설정 파일에 봇 토큰을 추가합니다.

# 환경 변수로 설정
export TELEGRAM_BOT_TOKEN="123456:ABCDEF"

또는 설정 파일:

{
  "channels": {
    "telegram": {
      "botToken": "123456:ABCDEF",
      "allowFrom": ["@username"],
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

Discord 연동

{
  "channels": {
    "discord": {
      "token": "your_discord_bot_token",
      "dm": {
        "allowFrom": ["user_id_1", "user_id_2"]
      }
    }
  }
}

Slack 연동

export SLACK_BOT_TOKEN="xoxb-your-token"
export SLACK_APP_TOKEN="xapp-your-token"

---

보안 및 주의사항

기본 보안 정책

OpenClaw는 기본적으로 DM 페어링 모드로 작동합니다. 이는 알 수 없는 발신자가 메시지를 보낼 경우, 짧은 페어링 코드를 제공하고 실제 메시지는 처리하지 않는 방식입니다.

# 페어링 승인
openclaw pairing approve <channel> <code>

보안 모범 사례

1. 샌드박스 모드 사용: 그룹 채팅이나 공개 채널에서는 Docker 샌드박스 모드를 활성화하는 것이 좋습니다.

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main"
      }
    }
  }
}

1. 접근 제어: allowFrom 설정으로 허용된 사용자만 접근하도록 제한하세요.
2. 민감한 정보 관리: API 키, 비밀번호 등은 환경 변수로 관리하고, 설정 파일에 직접 저장하지 마세요.

알려진 보안 이슈

OpenClaw는 강력한 기능을 제공하지만, 동시에 프롬프트 인젝션, 권한 상승, 공급망 위험 등의 보안 취약점이 존재할 수 있습니다.

• 보안 연구자들은 OpenClaw를 고급 사용자를 위한 도구로 권장하며, 프로덕션 환경이나 민감한 데이터가 있는 시스템에 연결하지 말 것을 권고합니다.
• 가능한 한 격리된 환경(샌드박스)에서 실행하는 것이 안전합니다.

---

마치며

OpenClaw는 개인 AI 비서의 새로운 가능성을 보여주는 혁신적인 오픈소스 프로젝트입니다. 로컬 실행, 다양한 플랫폼 지원, 강력한 자동화 기능을 통해 일상적인 디지털 작업을 효율적으로 관리할 수 있습니다.

하지만 강력한 기능만큼이나 보안에 대한 주의가 필요합니다. 특히 민감한 정보에 접근하거나 프로덕션 환경에서 사용할 때는 샌드박스 모드를 활용하고, 접근 권한을 엄격하게 관리해야 합니다.

유용한 링크

• 공식 웹사이트: https://openclaw.ai
• GitHub 저장소: https://github.com/openclaw/openclaw
• 공식 문서: https://docs.openclaw.ai
• Discord 커뮤니티: https://discord.gg/clawd

OpenClaw에 대해 더 궁금한 점이 있으시면 공식 문서를 참고하거나 Discord 커뮤니티에 참여해보세요!

---

주의: OpenClaw는 빠르게 발전하고 있는 프로젝트입니다. 이 글의 정보는 2026년 2월 기준이며, 최신 정보는 공식 문서에서 확인하시기 바랍니다.