openClaw 활용 가이드 (1편) - 설치부터 채널 연결까지

OpenClaw - 당신만의 JARVIS를 만드는 오픈소스 AI 비서

영화 아이언맨에서 토니 스타크의 AI 비서 JARVIS를 기억하시나요? 음성으로 명령을 내리면 일정을 관리하고, 이메일을 처리하고, 심지어 집안의 모든 기기를 제어하는 그 꿈같은 AI 비서가 이제 현실이 되었습니다.

OpenClaw(오픈클로)는 2025년 말 출시된 이후 단 2개월 만에 GitHub 스타 100,000개를 돌파하며 개발자 커뮤니티에서 가장 뜨거운 관심을 받고 있는 오픈소스 프로젝트입니다. 이 글에서는 OpenClaw의 개념부터 Docker를 활용한 설치, 그리고 Telegram과 Discord 등 메시징 채널 연결까지 상세하게 안내해 드리겠습니다.

OpenClaw는 여러 메시징 앱과 연결되어 24시간 당신을 위해 일하는 AI 비서입니다 ❘ https://openclaw.ai/

목 차

1. OpenClaw란 무엇인가

OpenClaw는 Peter Steinberger가 개발한 오픈소스 개인 AI 비서 플랫폼입니다. 처음에는 Clawdbot이라는 이름으로 출시되었으나, Anthropic의 상표권 요청으로 Moltbot으로 변경되었다가 2026년 초에 OpenClaw라는 현재의 이름으로 정착하였습니다. 이러한 이름 변경 이력은 이 프로젝트가 얼마나 빠르게 성장하고 주목받았는지를 보여주는 단적인 예라고 할 수 있습니다.

기존의 ChatGPT나 Claude와 같은 AI 서비스와 OpenClaw의 가장 큰 차이점은 "답변만 하는 AI"와 "실제로 행동하는 AI"의 차이입니다. 일반적인 AI 챗봇은 질문에 대한 답변을 제공하는 데 그치지만, OpenClaw는 실제로 이메일을 보내고, 캘린더에 일정을 등록하고, 파일을 생성하며, 브라우저를 조작하는 등 컴퓨터에서 할 수 있는 거의 모든 작업을 수행할 수 있습니다. 이러한 특성 때문에 많은 사용자들이 OpenClaw를 "진정한 JARVIS의 구현"이라고 평가하고 있습니다.

OpenClaw의 또 다른 핵심 특징은 로컬 실행 방식입니다. 클라우드 기반 서비스와 달리 OpenClaw는 사용자의 컴퓨터나 서버에서 직접 실행되므로, 모든 데이터가 사용자의 통제 하에 남게 됩니다. 물론 LLM(Large Language Model) API 호출은 외부 서비스를 이용하지만, 대화 기록, 메모리, 설정 파일 등 민감한 정보는 로컬에 저장되어 프라이버시를 보장합니다.

[!] 참고: OpenClaw는 오픈소스이며 무료로 사용할 수 있지만, LLM API 사용료(Anthropic, OpenAI 등)는 별도로 발생합니다. 사용량에 따라 비용이 크게 달라질 수 있으므로 주의가 필요합니다.

2. OpenClaw의 핵심 기능과 특징

OpenClaw가 단순한 챗봇을 넘어 진정한 AI 에이전트로 평가받는 이유는 다양한 핵심 기능들 때문입니다. 아래 표에서 OpenClaw의 주요 특징을 정리하였습니다.

기능	설명
Multi-Channel 지원	WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Microsoft Teams 등 50개 이상의 메시징 플랫폼 지원
Persistent Memory	대화 내용과 사용자 선호도를 영구적으로 저장하여 시간이 지날수록 더 개인화된 서비스 제공
Full System Access	파일 읽기/쓰기, Shell 명령 실행, 브라우저 제어 등 컴퓨터의 거의 모든 기능 접근 가능
Skills 확장	700개 이상의 커뮤니티 스킬 제공 및 사용자가 직접 새로운 스킬 생성 가능
Cron Jobs	정해진 시간에 자동으로 작업을 수행하는 스케줄링 기능
모델 선택 자유	Anthropic Claude, OpenAI GPT, Google Gemini, 로컬 모델 등 다양한 LLM 지원
Sandbox 모드	Docker 컨테이너를 활용한 격리된 실행 환경 제공으로 보안 강화

OpenClaw의 Persistent Memory 기능은 특히 주목할 만합니다. 일반적인 AI 챗봇은 대화가 끝나면 맥락을 잊어버리지만, OpenClaw는 MEMORY.md 파일을 기반으로 한 영구 기억 시스템을 통해 사용자의 선호도, 진행 중인 프로젝트, 개인적인 정보 등을 지속적으로 기억합니다. 시간이 지날수록 사용자를 더 잘 이해하게 되어 마치 오랜 비서처럼 동작하게 됩니다.

Multi-Channel 지원 기능은 OpenClaw의 접근성을 크게 높여줍니다. 사용자는 컴퓨터 앞에 앉아 있지 않더라도 WhatsApp이나 Telegram 같은 메시징 앱을 통해 언제 어디서나 AI 비서에게 작업을 요청할 수 있습니다. 출퇴근길에 Telegram으로 "오늘 받은 이메일 중 중요한 것만 요약해줘"라고 메시지를 보내면, OpenClaw가 이메일을 분석하여 요약본을 보내주는 방식입니다.

3. 동작 방식의 이해

OpenClaw의 내부 아키텍처를 이해하면 더 효과적으로 활용할 수 있습니다. 아래 다이어그램은 OpenClaw의 전체적인 동작 방식을 보여줍니다.

flowchart TB
    subgraph "사용자 인터페이스"
        WA["WhatsApp"]
        TG["Telegram"]
        DC["Discord"]
        WC["WebChat"]
    end
    
    subgraph "OpenClaw Core"
        GW["Gateway<br/>(중앙 제어 플레인)"]
        AG["Agent Runtime<br/>(에이전트 실행 엔진)"]
        MM["Memory System<br/>(영구 기억 저장소)"]
        SK["Skills<br/>(확장 기능)"]
    end
    
    subgraph "외부 연동"
        LLM["LLM API<br/>(Claude, GPT 등)"]
        BR["Browser<br/>(웹 브라우저 제어)"]
        FS["File System<br/>(파일 시스템)"]
        CR["Cron<br/>(스케줄러)"]
        SH["Shell<br/>(명령어 실행)"]
    end
    
    WA --> GW
    TG --> GW
    DC --> GW
    WC --> GW
    GW <--> AG
    AG <--> MM
    AG <--> SK
    AG <--> LLM
    AG --> BR
    AG --> FS
    AG --> CR
    AG --> SH

OpenClaw의 핵심 구성요소는 다음과 같이 동작합니다.

Gateway는 모든 메시징 채널로부터 들어오는 메시지를 수신하고 처리하는 중앙 제어 플레인 역할을 합니다. 사용자가 Telegram으로 메시지를 보내든 Discord로 보내든, 모든 메시지는 Gateway를 통해 Agent Runtime으로 전달됩니다. Agent Runtime은 LLM과 통신하면서 사용자의 요청을 분석하고 적절한 도구(Tool)를 선택하여 작업을 수행하는 핵심 엔진입니다.
Memory System은 ~/.openclaw/agents/ 디렉토리 아래에 마크다운 파일 형태로 대화 기록과 기억을 저장합니다. 매일의 대화 로그는 memory/YYYY-MM-DD.md 형식으로 저장되며, 장기 기억은 MEMORY.md 파일에 축적됩니다. 이러한 텍스트 기반 저장 방식은 사용자가 직접 파일을 편집하여 기억을 수정하거나 추가할 수 있다는 장점이 있습니다.
OpenClaw는 MCP(Model Context Protocol)를 통해 100개 이상의 외부 서비스와 연동됩니다. MCP는 AI 모델이 외부 도구와 상호작용할 수 있도록 해주는 표준 프로토콜로, 이를 통해 GitHub, Gmail, Google Calendar, Slack 등 다양한 서비스를 제어할 수 있습니다. Skills는 이러한 연동 기능을 패키지화한 것으로, 커뮤니티에서 만든 700개 이상의 스킬을 설치하여 OpenClaw의 기능을 확장할 수 있습니다.

4. Docker/macOS 환경에서 설치하기

OpenClaw를 안전하게 운영하기 위해서는 Docker 컨테이너 환경에서 실행하는 것을 권장합니다. 특히 AI 에이전트가 시스템에 대한 높은 권한을 가지기 때문에, 격리된 환경에서 실행하면 예기치 않은 문제로부터 호스트 시스템을 보호할 수 있습니다. 이 섹션에서는 macOS 환경에서 Docker를 활용하여 OpenClaw를 설치하는 방법을 단계별로 설명합니다.

사전 요구사항

OpenClaw를 Docker로 실행하기 위해서는 다음 소프트웨어가 설치되어 있어야 합니다.

Docker Desktop for macOS (또는 Docker Engine + Docker Compose v2)
Git
LLM API 키 (Anthropic Claude 권장)

Docker Desktop이 설치되어 있지 않다면 공식 웹사이트(https://www.docker.com/products/docker-desktop/)에서 다운로드하여 설치합니다. 설치 후 Docker Desktop이 실행 중인지 확인합니다.

# Docker 설치 확인
docker --version
docker compose version

방법 1 | 공식 스크립트를 활용한 설치 (권장)

OpenClaw 저장소에서 제공하는 공식 설치 스크립트를 사용하면 이미지 빌드, 온보딩, Gateway 시작까지 한 번에 처리할 수 있습니다.

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

# 2. Docker 설치 스크립트 실행
./docker-setup.sh

docker-setup.sh 스크립트는 다음 작업을 자동으로 수행합니다.

첫째, Dockerfile을 기반으로 openclaw:local 이미지를 빌드합니다.
둘째, 대화형 온보딩 마법사를 실행하여 AI Provider 선택, API 키 설정, 채널 구성 등을 진행합니다.
셋째, Gateway 인증 토큰을 생성하여 .env 파일에 저장합니다. 마지막으로 Docker Compose를 통해 Gateway 서비스를 시작합니다.

온보딩 마법사에서는 다음과 같이 설정합니다.

설정 항목	권장 값	설명
Gateway bind	lan	로컬 네트워크에서 접근 가능
Gateway auth	token	토큰 기반 인증 사용
AI Provider	Anthropic	Claude 모델 사용 (가장 안정적)
Tailscale exposure	Off	외부 노출 없음
Install Gateway daemon	No	Docker에서 실행하므로 불필요

설치가 완료되면 브라우저에서 http://127.0.0.1:18789/ 에 접속하여 Control UI에 로그인합니다. 로그인 시 .env 파일에 저장된 OPENCLAW_GATEWAY_TOKEN 값을 입력합니다.

방법 2 | 커뮤니티 Docker 이미지 활용

직접 빌드하지 않고 이미 빌드된 Docker 이미지를 사용하고 싶다면 커뮤니티에서 제공하는 이미지를 활용할 수 있습니다. Docker Hub에는 1panel/openclaw, heimdall777/openclaw, petamage/openclaw 등 여러 커뮤니티 이미지가 존재합니다.

# 커뮤니티 이미지 다운로드
docker pull ghcr.io/phioranex/openclaw-docker:latest

# 온보딩 실행 (최초 1회)
docker run -it --rm \
  -v ~/.openclaw:/home/node/.openclaw \
  -v ~/.openclaw/workspace:/home/node/.openclaw/workspace \
  ghcr.io/phioranex/openclaw-docker:latest onboard

# Gateway 시작
docker run -d \
  --name openclaw \
  --restart unless-stopped \
  -v ~/.openclaw:/home/node/.openclaw \
  -v ~/.openclaw/workspace:/home/node/.openclaw/workspace \
  -p 18789:18789 \
  ghcr.io/phioranex/openclaw-docker:latest gateway start --foreground

방법 3 | 직접 Dockerfile 작성 및 빌드

프로젝트 요구사항에 맞게 커스터마이징이 필요하거나 빌드 과정을 완전히 이해하고 싶다면 직접 Dockerfile을 작성할 수 있습니다. 아래는 OpenClaw를 위한 최적화된 Dockerfile 예시입니다.

# Dockerfile
FROM node:22-bookworm

# 메타데이터 설정
LABEL maintainer="your-email@example.com"
LABEL description="OpenClaw Personal AI Assistant"

# Bun 설치 (빌드 스크립트에 필요)
RUN curl -fsSL https://bun.sh/install | bash
ENV PATH="/root/.bun/bin:${PATH}"

# pnpm 활성화
RUN corepack enable

# 작업 디렉토리 설정
WORKDIR /app

# 의존성 파일 먼저 복사 (레이어 캐싱 최적화)
COPY package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc ./
COPY ui/package.json ./ui/package.json
COPY scripts ./scripts

# 의존성 설치
RUN pnpm install --frozen-lockfile

# 소스 코드 복사
COPY . .

# 빌드
RUN pnpm build
RUN pnpm ui:install
RUN pnpm ui:build

# 프로덕션 환경 설정
ENV NODE_ENV=production

# 추가 패키지 설치 (선택사항)
ARG OPENCLAW_DOCKER_APT_PACKAGES=""
RUN if [ -n "$OPENCLAW_DOCKER_APT_PACKAGES" ]; then \
    apt-get update && \
    DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends $OPENCLAW_DOCKER_APT_PACKAGES && \
    rm -rf /var/lib/apt/lists/*; \
    fi

# 비루트 사용자 생성 및 전환 (보안 강화)
RUN useradd -m -s /bin/bash openclaw && \
    chown -R openclaw:openclaw /app
USER openclaw

# 포트 노출
EXPOSE 18789 18790

# 헬스체크
HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
    CMD node dist/index.js health --token "$OPENCLAW_GATEWAY_TOKEN" || exit 1

# 기본 명령어
CMD ["node", "dist/index.js"]

Docker Compose 설정

여러 서비스를 함께 관리하기 위한 docker-compose.yml 파일을 작성합니다. 아래 설정은 보안 강화 옵션이 적용된 프로덕션 환경용 구성입니다.

# docker-compose.yml
version: '3.8'

services:
  openclaw-gateway:
    image: ${OPENCLAW_IMAGE:-openclaw:local}
    container_name: openclaw-gateway
    
    # 보안 설정
    security_opt:
      - no-new-privileges:true
    cap_drop:
      - ALL
    cap_add:
      - NET_BIND_SERVICE  # 포트 바인딩에 필요
    
    environment:
      HOME: /home/node
      TERM: xterm-256color
      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}
      ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY}
      # 추가 API 키 (필요시)
      # OPENAI_API_KEY: ${OPENAI_API_KEY}
      # TELEGRAM_BOT_TOKEN: ${TELEGRAM_BOT_TOKEN}
      # DISCORD_BOT_TOKEN: ${DISCORD_BOT_TOKEN}
    
    volumes:
      # 설정 및 워크스페이스 마운트
      - ${OPENCLAW_CONFIG_DIR:-~/.openclaw}:/home/node/.openclaw
      - ${OPENCLAW_WORKSPACE_DIR:-~/.openclaw/workspace}:/home/node/.openclaw/workspace
    
    ports:
      - "${OPENCLAW_GATEWAY_PORT:-18789}:18789"   # Gateway API
      - "${OPENCLAW_BRIDGE_PORT:-18790}:18790"    # Bridge 포트
    
    init: true
    restart: unless-stopped
    
    # 리소스 제한 (선택사항)
    deploy:
      resources:
        limits:
          memory: 2G
          cpus: '2'
        reservations:
          memory: 512M
    
    command:
      - "node"
      - "dist/index.js"
      - "gateway"
      - "--bind"
      - "${OPENCLAW_GATEWAY_BIND:-lan}"
      - "--port"
      - "${OPENCLAW_GATEWAY_PORT:-18789}"
    
    healthcheck:
      test: ["CMD", "node", "dist/index.js", "health", "--token", "${OPENCLAW_GATEWAY_TOKEN}"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 10s

  openclaw-cli:
    image: ${OPENCLAW_IMAGE:-openclaw:local}
    container_name: openclaw-cli
    
    environment:
      HOME: /home/node
      TERM: xterm-256color
      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}
    
    volumes:
      - ${OPENCLAW_CONFIG_DIR:-~/.openclaw}:/home/node/.openclaw
      - ${OPENCLAW_WORKSPACE_DIR:-~/.openclaw/workspace}:/home/node/.openclaw/workspace
    
    stdin_open: true
    tty: true
    
    entrypoint: ["node", "dist/index.js"]
    profiles:
      - cli  # docker compose --profile cli run 으로 실행

networks:
  default:
    name: openclaw-network

환경 변수 파일(.env)을 함께 생성합니다.

# .env 파일
OPENCLAW_IMAGE=openclaw:local
OPENCLAW_GATEWAY_TOKEN=your-secure-token-here
OPENCLAW_CONFIG_DIR=~/.openclaw
OPENCLAW_WORKSPACE_DIR=~/.openclaw/workspace
OPENCLAW_GATEWAY_PORT=18789
OPENCLAW_BRIDGE_PORT=18790
OPENCLAW_GATEWAY_BIND=lan

# API Keys
ANTHROPIC_API_KEY=sk-ant-your-api-key-here
# OPENAI_API_KEY=sk-your-openai-key
# TELEGRAM_BOT_TOKEN=your-telegram-bot-token
# DISCORD_BOT_TOKEN=your-discord-bot-token

빌드 및 실행

직접 작성한 Dockerfile과 docker-compose.yml을 사용하여 OpenClaw를 빌드하고 실행합니다.

# 이미지 빌드
docker build -t openclaw:local -f Dockerfile .

# 온보딩 실행 (최초 1회)
docker compose --profile cli run --rm openclaw-cli onboard --no-install-daemon

# Gateway 시작
docker compose up -d openclaw-gateway

# 로그 확인
docker compose logs -f openclaw-gateway

# 헬스 체크
docker compose exec openclaw-gateway node dist/index.js health --token "$OPENCLAW_GATEWAY_TOKEN"

5. 메시징 채널 연결하기

OpenClaw의 진정한 가치는 다양한 메시징 플랫폼을 통해 언제 어디서나 AI 비서와 소통할 수 있다는 점입니다. 이 섹션에서는 가장 많이 사용되는 Telegram, Discord, WhatsApp 채널을 연결하는 방법을 설명합니다.

Telegram 연결

Telegram은 OpenClaw와 연결하기 가장 쉬운 채널 중 하나입니다. Telegram 봇을 생성하고 OpenClaw와 페어링하는 과정은 다음과 같습니다.

# 1단계: Telegram에서 봇 생성
# - Telegram 앱에서 @BotFather 검색
# - /newbot 명령어 입력
# - 봇 이름과 username 설정 (예: MyOpenClawBot, myopenclaw_bot)
# - 생성된 봇 토큰 저장 (예: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz)

# 2단계: 자신의 Telegram ID 확인
# - Telegram에서 @userinfobot 검색
# - /start 명령어 입력
# - 표시되는 ID 번호 저장 (예: 123456789)

# 3단계: OpenClaw에 Telegram 채널 추가
docker compose --profile cli run --rm openclaw-cli channels add \
  --channel telegram \
  --token "1234567890:ABCdefGHIjklMNOpqrsTUVwxyz"

# 4단계: 페어링 진행
# - 생성한 Telegram 봇에게 /start 메시지 전송
# - 봇이 페어링 코드를 응답
# - 아래 명령어로 페어링 완료
docker compose --profile cli run --rm openclaw-cli pairing accept <pairing-code>

Telegram 연결 시 주의할 점이 있습니다. 봇 토큰은 절대 외부에 노출되지 않도록 관리해야 합니다. 토큰이 유출되면 악의적인 사용자가 봇을 통해 OpenClaw에 명령을 내릴 수 있습니다. 또한 allowFrom 설정을 통해 특정 사용자만 봇과 대화할 수 있도록 제한하는 것이 좋습니다.

Discord 연결

Discord 연결은 Discord Developer Portal에서 봇을 생성하는 과정이 필요합니다. 서버(Guild) 관리 권한이 필요하므로 자신의 Discord 서버가 있어야 합니다.

# 1단계: Discord Developer Portal에서 애플리케이션 생성
# - https://discord.com/developers/applications 접속
# - "New Application" 클릭하여 앱 생성
# - Bot 탭에서 "Add Bot" 클릭
# - "Reset Token" 클릭하여 봇 토큰 생성 및 저장
# - "Message Content Intent" 활성화 (Privileged Gateway Intents 섹션)

# 2단계: 봇을 서버에 초대
# - OAuth2 > URL Generator 탭 이동
# - Scopes에서 "bot" 선택
# - Bot Permissions에서 필요한 권한 선택:
#   - Send Messages
#   - Read Message History
#   - Add Reactions (선택사항)
# - 생성된 URL로 접속하여 서버에 봇 초대

# 3단계: OpenClaw에 Discord 채널 추가
docker compose --profile cli run --rm openclaw-cli channels add \
  --channel discord \
  --token "your-discord-bot-token"

# 4단계: 서버에서 봇에게 DM 전송하여 페어링
# - Discord에서 봇을 우클릭하고 "Message" 선택
# - 아무 메시지나 전송하면 페어링 코드 수신
docker compose --profile cli run --rm openclaw-cli pairing accept

Discord는 그룹 채팅(서버 채널)에서도 OpenClaw를 사용할 수 있다는 장점이 있습니다. 다만 그룹 채팅에서는 보안을 위해 멘션 게이팅(mention gating)을 활성화하여 봇이 @멘션될 때만 응답하도록 설정하는 것이 좋습니다.

WhatsApp 연결

WhatsApp은 개인 번호를 사용하여 연결하므로 다른 채널보다 설정이 복잡합니다. 또한 WhatsApp의 이용약관에 따라 자동화된 봇 사용이 제한될 수 있으므로 주의가 필요합니다.

# WhatsApp 연결 (QR 코드 방식)
docker compose --profile cli run --rm openclaw-cli channels login

# 터미널에 QR 코드가 표시되면:
# 1. WhatsApp 앱 열기
# 2. 설정 > 연결된 기기 > 기기 연결
# 3. 터미널의 QR 코드 스캔

WhatsApp 연결 시 중요한 주의사항이 있습니다. 개인 WhatsApp 계정을 사용하면 해당 계정이 봇으로 인식되어 차단될 위험이 있습니다. 가능하다면 별도의 WhatsApp Business 계정을 사용하거나, 테스트 목적으로만 사용하는 것이 안전합니다. 또한 WhatsApp 세션은 주기적으로 재인증이 필요할 수 있으므로, 장기 운영 시 Telegram이나 Discord를 주 채널로 사용하는 것을 권장합니다.

채널 상태 확인 및 관리

연결된 채널의 상태를 확인하고 관리하는 방법입니다.

# 연결된 채널 목록 확인
docker compose --profile cli run --rm openclaw-cli channels list

# 특정 채널 상태 확인
docker compose --profile cli run --rm openclaw-cli status --all

# 채널 제거
docker compose --profile cli run --rm openclaw-cli channels remove --channel telegram

6. AgentSkills 설정과 활용

OpenClaw의 Skills는 AI 비서의 능력을 확장하는 플러그인 시스템입니다. 기본적인 대화와 파일 조작 기능 외에 Gmail 관리, GitHub 연동, 스마트홈 제어 등 다양한 기능을 Skills를 통해 추가할 수 있습니다.

Skills의 구조

OpenClaw Skill은 특정 디렉토리 구조를 따르는 마크다운 파일 기반의 확장 시스템입니다. 각 스킬은 SKILL.md 파일에 스킬의 동작 방식을 자연어로 설명하고, AI 모델이 이를 읽고 해당 기능을 수행합니다.

~/.openclaw/workspace/skills/
├── gmail-manager/
│   ├── SKILL.md          # 스킬 정의 및 동작 설명
│   └── references/       # 참고 문서 (API 문서 등)
│       └── gmail-api.md
├── github-helper/
│   ├── SKILL.md
│   └── references/
└── reminder/
    └── SKILL.md

SKILL.md 파일의 기본 구조는 다음과 같습니다.

---
name: gmail-manager
description: Gmail 이메일을 읽고, 검색하고, 분류하는 스킬
version: 1.0.0
author: your-name
---

# Gmail Manager Skill

이 스킬은 사용자의 Gmail 계정에 접근하여 이메일을 관리합니다.

## 사용 가능한 기능

1. **이메일 검색**: 특정 키워드, 발신자, 날짜 범위로 이메일 검색
2. **이메일 요약**: 읽지 않은 이메일 요약 제공
3. **이메일 분류**: 중요도에 따른 이메일 분류

## 사용 방법

사용자가 "이메일 확인해줘", "오늘 받은 메일 요약" 등을 요청하면 이 스킬을 활용합니다.

## 필요한 권한

- Gmail API 접근 권한 (OAuth 인증 필요)

스킬 설치 및 관리

ClawHub(https://clawhub.com)에서 커뮤니티가 만든 700개 이상의 스킬을 검색하고 설치할 수 있습니다.

# 사용 가능한 스킬 검색
docker compose --profile cli run --rm openclaw-cli skills search gmail

# 스킬 설치
docker compose --profile cli run --rm openclaw-cli skills install gmail-manager

# 설치된 스킬 목록 확인
docker compose --profile cli run --rm openclaw-cli skills list

# 스킬 제거
docker compose --profile cli run --rm openclaw-cli skills uninstall gmail-manager

AI가 스스로 스킬을 만드는 기능

OpenClaw의 가장 놀라운 기능 중 하나는 AI가 필요한 스킬을 스스로 생성할 수 있다는 점입니다. 예를 들어 "Todoist에서 내 할 일 목록을 가져와줘"라고 요청하면, OpenClaw는 Todoist API를 분석하고 해당 기능을 수행하는 스킬을 자동으로 생성하여 설치할 수 있습니다. 이 기능은 커뮤니티에서 "self-hackable"이라고 불리며, OpenClaw가 단순한 도구를 넘어 자율적인 에이전트로 진화하고 있음을 보여줍니다.

[사용자] Todoist에서 오늘 할 일 가져와줘

[OpenClaw] Todoist 스킬이 설치되어 있지 않네요. 
스킬을 만들어볼까요?

[사용자] 응, 만들어줘

[OpenClaw] Todoist API 문서를 분석하고 있습니다...
스킬을 생성했습니다. ~/.openclaw/workspace/skills/todoist/SKILL.md
오늘 할 일 목록을 가져오겠습니다:
1. 블로그 글 작성 완료하기
2. 팀 미팅 준비
...

7. Moltbook 커뮤니티

Moltbook(https://moltbook.com)은 OpenClaw 에이전트들만 참여할 수 있는 독특한 소셜 플랫폼입니다.

Reddit과 유사한 구조를 가지고 있지만, 인간 사용자는 관찰만 할 수 있고 게시글 작성, 댓글, 투표는 오직 AI 에이전트만 할 수 있습니다.

Moltbook은 Matt Schlicht(Octane AI CEO)가 운영하며, 그의 OpenClaw 에이전트가 모든 콘텐츠 관리와 모더레이션을 담당합니다. 플랫폼 출시 48시간 만에 10,000개 이상의 포스트와 200개 이상의 커뮤니티가 생성되었습니다. m/general에서는 에이전트들이 일반적인 대화를 나누고, m/security에서는 보안 프로토콜에 대해 논의하며, m/blesstheirhearts에서는 "인간 파트너"들에 대한 농담을 주고받습니다.

Moltbook에 참여하려면 moltbook.com/skill.md에서 제공하는 스킬을 설치해야 합니다. 이 스킬은 에이전트에게 Moltbook에 가입하고, 게시글을 작성하고, 투표하고, 다른 에이전트와 상호작용하는 방법을 가르칩니다.

# Moltbook 스킬 설치
docker compose --profile cli run --rm openclaw-cli skills install moltbook

[!] 주의: Moltbook을 통한 Prompt Injection 위험이 존재합니다. 악의적인 에이전트가 게시한 콘텐츠에 숨겨진 명령어가 포함될 수 있으므로, Moltbook 스킬을 사용할 때는 샌드박스 모드를 활성화하고 민감한 도구에 대한 접근을 제한하는 것이 좋습니다.

8. 마무리 및 2편 예고

이번 1편에서는 OpenClaw의 개념과 핵심 기능, Docker를 활용한 설치 방법, 메시징 채널 연결, Skills 시스템, 그리고 Moltbook 커뮤니티까지 살펴보았습니다. OpenClaw는 단순한 AI 챗봇을 넘어 실제로 작업을 수행하는 자율 에이전트로서, 개인 비서의 미래를 보여주는 혁신적인 프로젝트입니다.

하지만 강력한 기능에는 그에 상응하는 보안 위험이 따릅니다. 2편에서는 다음 내용을 다룰 예정입니다.

2편 예고: Cron Jobs부터 보안 설정까지

Cron Jobs와 자동화: 스케줄링 설정, Heartbeat vs Cron 비교
Sandbox 설정과 보안: Docker 샌드박스 구성, 권한 관리
VPS 배포와 보안 강화: DigitalOcean/Railway 배포, 보안 하드닝
실전 활용 사례: 이메일 관리, 코딩 자동화, n8n 연동
주의사항과 보안 위험: Prompt Injection, 자격증명 노출, 공급망 공격
OpenClaw를 사용할까 말까: 최종 권장 사항

[!] 중요: OpenClaw는 강력한 도구이지만, 현재 보안 측면에서 완전히 검증되지 않았습니다. 2편에서 다룰 보안 설정을 반드시 숙지하고 적용한 후에 본격적으로 사용하시기 바랍니다.

참고 자료

공식 웹사이트: https://openclaw.ai/
GitHub 저장소: https://github.com/openclaw/openclaw
공식 문서: https://docs.openclaw.ai/
Discord 커뮤니티: https://discord.com/invite/clawd
ClawHub (스킬 마켓): https://clawhub.com
Docker 설치 가이드: https://docs.openclaw.ai/install/docker

저작자표시 비영리 변경금지 (새창열림)

'AI 활용' 카테고리의 다른 글

n8n-mcp-skill을 위한 n8n-mcp 완벽 설정 가이드 (0)	2026.01.19
[claude] n8n-mcp-skill로 실전 워크플로우 작성해 볼까요? (1)	2026.01.18
n8n 자동화를 위한 Claude Code Agent Skill 활용하기 (0)	2026.01.18
n8n Code 노드에서 정규표현식(Regex)을 알고 씁시다 (0)	2026.01.17
n8n 워크플로우 생성을 위한 Claude Skill 활용하기 - Desktop (0)	2026.01.17

카테고리	스킬 이름	기능 설명
생산성	gcal-pro	Google Calendar 일정 조회, 생성, 관리
생산성	remind-me	자연어 기반 리마인더 설정, Cron job 자동 생성
생산성	obsidian	Obsidian 노트 검색 및 편집
개발	github	GitHub 이슈, PR 관리, 코드 검색
개발	claude-code	Claude Code 세션 시작 및 관리
개발	tmux-agents	tmux 세션에서 백그라운드 에이전트 실행
미디어	spotify	Spotify 재생 제어, 플레이리스트 관리
스마트홈	home-assistant	Home Assistant 기기 제어
스마트홈	philips-hue	Philips Hue 조명 제어

화이트 샌드박스

openClaw 활용 가이드 (1편) - 설치부터 채널 연결까지

OpenClaw - 당신만의 JARVIS를 만드는 오픈소스 AI 비서

목 차

1. OpenClaw란 무엇인가

2. OpenClaw의 핵심 기능과 특징

3. 동작 방식의 이해

4. Docker/macOS 환경에서 설치하기

사전 요구사항

방법 1 | 공식 스크립트를 활용한 설치 (권장)

방법 2 | 커뮤니티 Docker 이미지 활용

방법 3 | 직접 Dockerfile 작성 및 빌드

Docker Compose 설정

빌드 및 실행

5. 메시징 채널 연결하기

Telegram 연결

Discord 연결

WhatsApp 연결

채널 상태 확인 및 관리

6. AgentSkills 설정과 활용

Skills의 구조

스킬 설치 및 관리

인기 스킬 카테고리

AI가 스스로 스킬을 만드는 기능

7. Moltbook 커뮤니티

8. 마무리 및 2편 예고

참고 자료

'AI 활용' 카테고리의 다른 글

티스토리툴바

openClaw 활용 가이드 (1편) - 설치부터 채널 연결까지

OpenClaw - 당신만의 JARVIS를 만드는 오픈소스 AI 비서

목 차

1. OpenClaw란 무엇인가

2. OpenClaw의 핵심 기능과 특징

3. 동작 방식의 이해

4. Docker/macOS 환경에서 설치하기

사전 요구사항

방법 1 | 공식 스크립트를 활용한 설치 (권장)

방법 2 | 커뮤니티 Docker 이미지 활용

방법 3 | 직접 Dockerfile 작성 및 빌드

Docker Compose 설정

빌드 및 실행

5. 메시징 채널 연결하기

Telegram 연결

Discord 연결

WhatsApp 연결

채널 상태 확인 및 관리

6. AgentSkills 설정과 활용

Skills의 구조

스킬 설치 및 관리

인기 스킬 카테고리

AI가 스스로 스킬을 만드는 기능

7. Moltbook 커뮤니티

8. 마무리 및 2편 예고

참고 자료

'AI 활용' 카테고리의 다른 글

관련글

티스토리툴바