OpenClaw 완벽 가이드: 첫 설치부터 파워 유저까지

OpenClaw란 무엇이고, 왜 주목해야 할까요?

OpenClaw는 여러분의 기기에서 직접 실행되는 오픈소스 AI 에이전트입니다 -- 노트북, 홈 서버, 또는 클라우드 VPS 어디에서든 사용할 수 있습니다. 단순히 질문에 답변하는 브라우저 기반 AI 도구와 달리, OpenClaw는 직접 행동합니다: 이메일을 읽고, 회의 일정을 잡고, 파일을 정리하고, WhatsApp, Telegram, Discord를 통해 메시지를 보내며, 반복적인 워크플로우를 자동화합니다 -- 모두 자연어를 통해서요.

2026년 1월 출시 이후, 이 프로젝트는 GitHub 스타 244,000개를 돌파하며 역대 가장 빠르게 성장하는 오픈소스 저장소 중 하나가 되었습니다. 이유는 간단합니다: 사람들은 단순히 할 일에 대해 이야기하는 AI가 아니라, 실제로 일을 처리하는 AI 어시스턴트를 원하기 때문입니다.

차이점을 쉽게 이해할 수 있는 예시를 보겠습니다:

기존 AI 챗봇:

사용자: "바탕화면 파일 좀 정리해줘." AI: "네! 여기 몇 가지 팁이 있습니다: 1. 유형별로 폴더를 만드세요... 2. 그에 맞게 파일을 옮기세요..."

OpenClaw:

사용자: "바탕화면 파일 좀 정리해줘." OpenClaw: 47개 파일의 이름을 변경하고, 분류하여 5개 폴더로 이동합니다 -- "완료! 파일 유형별로 모두 정리했습니다."

이것이 핵심적인 변화입니다: 챗봇에서 에이전트로의 전환.

이 가이드는 첫 설치부터 커스텀 Skills 작성, 다중 에이전트 관리까지 전체 과정을 안내합니다. 30분이든 오후 내내든, 자신의 속도에 맞춰 각 섹션을 진행하세요.

시작하기: 설치 및 설정

필요한 것

• Node.js 22+ (LTS 권장) -- node --version으로 확인하기
• AI 모델 API Key -- Anthropic Claude(권장), OpenAI, 또는 Ollama를 통한 로컬 모델
• macOS, Linux, 또는 WSL2가 설치된 Windows

OpenClaw 설치

가장 빠른 방법은 한 줄 설치 명령어입니다:

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

이 명령어는 시스템을 감지하고, 필요한 종속성을 설치한 후 설정 마법사를 실행합니다. npm을 선호한다면:

npm install -g openclaw@latest

Docker 사용자의 경우:

docker pull openclaw/openclaw:latest
docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

각 방법에 대한 자세한 안내는 Quickstart 가이드를 참고하세요.

온보딩 마법사 실행

설치 후, 마법사가 모든 설정 과정을 안내합니다:

openclaw onboard

세 가지를 설정하게 됩니다:

1. AI 제공자 및 API Key -- Anthropic Claude가 가장 잘 작동합니다. 아직 키가 없다면 anthropic.com에서 발급받으세요. 비용이 걱정된다면 모델 선택 및 비용 가이드를 참고하세요.
2. 메시징 채널 -- 최소 하나를 선택하세요: Telegram이 시작하기 가장 쉽습니다(5분 설정). Telegram, WhatsApp, Discord 전용 가이드를 제공합니다.
3. 보안 모드 -- 지금은 Sandbox를 선택하세요. 익숙해지면 나중에 전체 접근 권한으로 업그레이드할 수 있습니다.

정상 작동 확인

openclaw status

다음과 같이 표시되어야 합니다:

Gateway: Running ✓
Model: Connected ✓
Channels: 1 active

이제 선택한 메시징 앱을 열고 첫 번째 메시지를 보내보세요. 간단한 것부터 시도해보세요:

• "뭘 할 수 있어?"
• "지금 몇 시야?"
• "최신 기술 뉴스를 요약해줘."

봇이 응답하면 축하합니다 -- AI 에이전트가 정상 작동하고 있습니다.

핵심 개념: OpenClaw의 작동 원리

더 깊이 들어가기 전에, OpenClaw의 네 가지 구성 요소를 이해하면 도움이 됩니다. 다음과 같이 생각해보세요:

Gateway -- 출입구

Gateway는 OpenClaw가 외부 세계와 연결되는 방식입니다. Telegram, Discord, WhatsApp, Web API, 또는 명령줄에서 들어오는 메시지를 처리합니다. 여러 Gateway를 동시에 실행할 수 있습니다 -- 예를 들어, 개인용으로 Telegram을, 업무용으로 Slack을 사용할 수 있습니다.

Skills -- 도구 상자

Skills는 OpenClaw가 할 수 있는 것입니다. 각 Skill은 패키징된 기능입니다: 이메일 전송, 웹 검색, 파일 관리, 브라우저 제어 등. 스마트폰의 앱처럼 생각하면 됩니다. OpenClaw에는 몇 가지 기본 Skills가 포함되어 있지만, 진정한 힘은 Clawhub의 커뮤니티 생태계와 직접 작성하는 것에서 나옵니다.

Skills 디렉토리에서 사용 가능한 것들을 둘러보세요.

Memory -- 두뇌

OpenClaw는 대화 간에 정보를 기억합니다. 이름, 근무 일정, 선호 사항을 알려주면 그 맥락을 유지합니다. 상태를 저장하지 않는 챗봇과 달리, OpenClaw는 여러분이 누구인지, 어떻게 일하는지에 대한 지속적인 이해를 구축하며, ~/.openclaw/memory/에 로컬로 저장됩니다.

Sandbox -- 안전망

Sandbox는 OpenClaw가 시스템에서 수행할 수 있는 작업을 제어합니다. Sandbox 모드에서는 임의의 파일에 접근하거나 파괴적인 명령을 실행할 수 없습니다. 이것은 여러분의 안전 장치입니다 -- 특히 새로운 Skills를 실험하거나 OpenClaw에 더 넓은 권한을 부여할 때 중요합니다.

상세한 보안 설정은 보안 설정 템플릿을 참고하세요.

Skills 설치 및 사용

Skills는 OpenClaw를 "흥미로운 데모"에서 "매일 사용하는 도구"로 바꿔줍니다. 시작하는 방법을 알아보겠습니다.

탐색 및 설치

# 키워드로 Skills 검색
openclaw skills search email

# 특정 Skill의 상세 정보 확인
openclaw skills info @openclaw/email-manager

# 설치
openclaw skills install @openclaw/email-manager

먼저 설치할 만한 5가지 Skills

| Skill | 기능 | 설치 명령어 | |-------|------|------------| | Email Manager | 이메일 읽기, 작성, 전송 | openclaw skills install @openclaw/email-manager | | Calendar | 이벤트 생성, 일정 확인, 초대 발송 | openclaw skills install @openclaw/calendar | | File Organizer | 파일 정렬, 이름 변경, 정리 | openclaw skills install @openclaw/file-organizer | | Web Search | 웹 검색 및 결과 요약 | openclaw skills install @openclaw/tavily-search | | Browser Control | 브라우저 작업 자동화 | openclaw plugins install @openclaw/browser-control |

설치 후, 에이전트에게 자연스럽게 말하기만 하면 됩니다:

• "읽지 않은 이메일을 확인하고 상위 3개를 요약해줘."
• "내일 일정에 뭐가 있어?"
• "최신 OpenClaw 릴리즈 노트를 검색해줘."

Skills 관리

# 설치된 모든 Skills 목록 확인
openclaw skills list

# 모든 Skills 업데이트
openclaw skills update

# 더 이상 필요 없는 Skill 제거
openclaw skills remove @openclaw/file-organizer

서드파티 Skills를 설치하기 전에, 안전을 위해 Skills 보안 체크리스트를 확인하세요.

자동화 설정 (Cron Jobs)

OpenClaw의 가장 실용적인 기능 중 하나는 예약 자동화입니다. 매일 아침 에이전트에게 무언가를 요청하는 대신, 한 번만 설정하면 자동으로 실행됩니다.

데일리 브리핑 만들기

에이전트에게 자연어로 말하기만 하면 됩니다:

"매일 아침 8시에 오늘의 날씨, 캘린더 일정, 읽지 않은 이메일 수가 포함된 브리핑을 보내줘."

OpenClaw가 자동으로 Cron Job을 생성합니다. 수동으로 관리할 수도 있습니다:

# 예약된 모든 작업 목록 확인
openclaw cron list

# 특정 작업의 상세 정보 확인
openclaw cron show <task-id>

# 작업 일시 중지
openclaw cron disable <task-id>

# 작업 재개
openclaw cron enable <task-id>

# 작업 영구 삭제
openclaw cron delete <task-id>

자동화 아이디어

• 데일리 브리핑 -- 매일 아침 날씨 + 캘린더 + 읽지 않은 이메일
• 주간 요약 -- 금요일 오후 주간 활동 보고서
• 가격 추적기 -- 제품 페이지를 모니터링하고 가격이 내려가면 알림
• 퇴근 알림 -- 오후 6시에 업무 마무리를 위한 친절한 알림
• 받은편지함 정리 -- 매일 저녁 낮은 우선순위 이메일 자동 보관

영구 메모리 설정

OpenClaw의 메모리 시스템은 개인화된 느낌을 만들어줍니다. 더 많은 맥락을 제공할수록, 더 잘 도와줍니다.

에이전트에게 자신에 대해 알려주기

다음과 같은 메시지를 보내세요:

"나에 대해 이것을 기억해: 내 이름은 Alex야. 프로덕트 매니저야. 월요일부터 금요일까지, 오전 9시부터 오후 6시까지 일해, 시간대는 GMT+8이야. 간결한 응답을 선호해. 영어로 소통하지만 중국어도 읽을 수 있어."

OpenClaw는 이를 장기 메모리에 저장하고 이후 모든 상호작용에 적용합니다.

메모리 확인 및 편집

# 에이전트가 기억하는 내용 확인
cat ~/.openclaw/memory/long-term.json

# 또는 채팅에서 직접 물어보기
"나에 대해 뭘 알고 있어?"

메모리를 수정하거나 삭제할 수도 있습니다:

"이전 근무 일정은 잊어줘. 이제 오전 10시부터 오후 7시까지 일해."

메모리 작동 방식

OpenClaw는 세 가지 계층의 메모리를 사용합니다:

• 단기 메모리 -- 현재 대화 맥락 (각 세션 후 초기화)
• 장기 메모리 -- 여러분에 대한 지속적인 사실 (선호사항, 습관, 인적 정보)
• 에피소드 메모리 -- 과거 상호작용 기록 (시간에 따른 패턴 인식에 사용)

이러한 계층적 접근 방식 덕분에 에이전트는 지속적인 리마인더 없이도 사용할수록 더 유용해집니다.

첫 번째 커스텀 Skill 작성하기

기본 제공 및 커뮤니티 Skills가 특정 요구를 충족하지 못할 때, 직접 작성할 수 있습니다. OpenClaw Skills는 간단한 YAML 형식을 사용합니다.

Skill 구조

~/.openclaw/skills/daily-news.yaml에 새 파일을 생성하세요:

name: "Daily Tech News"
description: "Fetches and summarizes today's top tech headlines"
version: "1.0.0"

triggers:
  - "tech news"
  - "today's news"
  - "news summary"

steps:
  - action: web_search
    query: "top tech news today"
    max_results: 5

  - action: summarize
    content: "{{search_results}}"
    style: "bullet_points"

  - action: respond
    message: |
      Here's your tech news summary:

      {{summary}}

테스트하기

# 새 파일을 반영하기 위해 Skills 다시 로드
openclaw skills reload

# 테스트 실행
openclaw skills test "Daily Tech News"

그런 다음 대화에서 시도해보세요: "오늘의 기술 뉴스 알려줘."

더 복잡한 Skills 만들기

Skills는 여러 액션을 체이닝할 수 있습니다:

• web_search -- 웹 검색
• summarize -- 텍스트를 불릿 포인트 또는 단락으로 요약
• respond -- 포맷된 답변 전송
• file_read / file_write -- 파일 읽기 또는 생성
• shell_exec -- 셸 명령 실행 (적절한 권한 필요)
• http_request -- 외부 API 호출

이들을 조합하여 다음과 같은 워크플로우를 구축할 수 있습니다: 항공편 가격 검색 -> 결과 비교 -> 파일에 요약 작성 -> Telegram으로 알림.

다중 에이전트 관리

사용량이 늘어나면, 생활의 다른 영역에 맞는 별도의 에이전트가 필요할 수 있습니다 -- 업무용, 개인용, 실험용.

에이전트 생성

# Claude Sonnet으로 업무 에이전트 생성
openclaw create-agent work
openclaw config --agent work set ai.model "claude-sonnet-4-6"

# 개인 에이전트 생성
openclaw create-agent personal
openclaw config --agent personal set ai.model "claude-haiku-4-5"

# 모든 에이전트 목록 확인
openclaw list-agents

# 에이전트 간 전환
openclaw switch-agent work

다중 에이전트를 사용하는 이유

| 에이전트 | 모델 | 연결 채널 | 용도 | |---------|------|----------|------| | Work | Claude Sonnet | Slack, Gmail, Linear | 업무 작업, 이메일 분류 | | Personal | Claude Haiku | Telegram, Google Calendar | 일정 관리, 알림, 개인 용무 | | Lab | Ollama (로컬) | CLI만 | 새 Skills 테스트, 실험 |

각 에이전트는 자체 메모리, Skills, 채널 연결을 가지며 -- 서로 완전히 격리되어 있습니다.

브라우저 자동화

OpenClaw는 단순한 API 호출을 넘어서는 작업을 수행하기 위해 브라우저를 제어할 수 있습니다: 폼 작성, 웹 페이지에서 데이터 추출, 여러 사이트의 가격 비교, 또는 스크린샷 촬영.

Browser Control 활성화

# 브라우저 플러그인 설치
openclaw plugins install @openclaw/browser-control

# 활성화
openclaw config set browser.enabled true

# 브라우저 창 표시 (디버깅 시 true로 설정)
openclaw config set browser.headless false

활용 사례

• "GitHub에 가서 오늘의 트렌딩 저장소 상위 목록을 찾아줘."
• "Amazon에 가서 기계식 키보드를 검색하고, 평점 기준 상위 3개를 가격과 함께 알려줘."
• "example.com의 연락처 양식을 내 정보로 작성해줘."
• "내 포트폴리오 웹사이트 스크린샷을 찍어줘."

브라우저 자동화는 강력하지만 리소스를 많이 사용합니다. 웹 페이지와 시각적 상호작용이 진정으로 필요한 작업에 사용하세요 -- 단순 데이터 수집은 Web Search Skill이 더 빠르고 저렴합니다.

채팅을 넘어선 통합

OpenClaw는 메시징 앱 이상으로 연결됩니다. 인기 있는 통합을 소개합니다:

Google Workspace

openclaw config set integrations.google.enabled true
openclaw config set integrations.google.credentialsPath "/path/to/credentials.json"
openclaw integrations google authorize

연결되면 자연어를 통해 Gmail, Google Calendar, Google Drive를 관리할 수 있습니다.

프로젝트 관리 (Linear, Jira)

openclaw skills install @openclaw/linear
openclaw config set integrations.linear.apiKey "YOUR_API_KEY"

"Linear에 높은 우선순위 작업 생성해줘: 로그인 페이지 리다이렉트 버그 수정."

노트 작성 (Obsidian, Notion)

openclaw skills install @openclaw/obsidian
openclaw config set integrations.obsidian.vaultPath "/path/to/vault"

"Obsidian에 '회의 노트 -- 3월 2일'이라는 제목으로 오늘의 논의 사항이 포함된 새 노트를 만들어줘."

지원되는 전체 플랫폼 목록은 채널 통합 디렉토리를 확인하세요.

보안 및 비용 관리

Docker Sandbox

최대한의 격리를 위해 Docker Sandbox 내에서 OpenClaw를 실행하세요:

openclaw config set sandbox.mode "docker"
openclaw config set sandbox.docker.image "openclaw/sandbox:latest"
openclaw sandbox test

이것은 파일 시스템 접근, 네트워크 접근, 셸 실행을 미리 정의된 범위로 제한합니다.

보안 감사 실행

openclaw security audit --deep

이 명령어는 잘못 설정된 권한, 노출된 토큰 및 기타 일반적인 문제를 점검합니다.

완전한 보안 강화 가이드는 포트 노출 및 원격 접근을 참고하세요.

지출 관리

API 비용이 누적될 수 있습니다. 가드레일을 설정하는 방법은 다음과 같습니다:

# 일일 요청 제한 설정
openclaw config set ai.dailyLimit 1000

# 월간 예산 상한 설정 (USD 단위)
openclaw config set ai.monthlyBudget 50

# 사용량 확인
openclaw stats usage
openclaw stats cost

일반적인 월간 비용:

| 사용 수준 | 설명 | 예상 비용 | |----------|------|----------| | 가벼운 사용 | 일 10-20회 대화 | $5--10/월 | | 보통 사용 | 일 50-100회 대화 + Cron Job | $20--30/월 | | 많은 사용 | 자동화 + 브라우저 제어 | $50--100/월 |

비용 최적화에 대해 더 알고 싶다면 모델 선택 및 비용 가이드를 참고하세요.

문제 해결 빠른 참조

| 증상 | 원인 가능성 | 해결 방법 | |------|-----------|----------| | 시작 시 EADDRINUSE | 포트 18789가 이미 사용 중 | openclaw gateway start --port 18790 | | 401 Unauthorized | 유효하지 않거나 만료된 API Key | openclaw config set api-key | | 봇이 응답하지 않음 | 채널이 연결되지 않음 | openclaw status 및 채널 설정 확인 | | 응답이 느림 | 모델 과부하 또는 네트워크 문제 | 가벼운 모델 시도 또는 연결 확인 | | Skills가 로드되지 않음 | 설치 후 리로드 필요 | openclaw skills reload |

더 자세한 문제 해결은 일반적인 오류 가이드를 참고하세요.

유용한 진단 명령어

# 전체 상태 점검
openclaw doctor

# 로그 확인
openclaw logs

# 디버그 모드
openclaw config set logging.level "debug"

다음 단계

많은 내용을 다루었습니다. 관심 분야에 따라 다음으로 진행할 수 있습니다:

• 더 많은 채널을 원하시나요? Slack과 Teams부터 WeChat과 Line까지 50+ 채널 통합 가이드를 탐색하세요.
• 보안에 관심이 있으시나요? Skills 보안 체크리스트와 보안 설정 가이드를 읽어보세요.
• 셀프 호스팅을 원하시나요? 원격 접근 및 포트 노출 가이드를 확인하세요.
• 기여하고 싶으시나요? OpenClaw GitHub 저장소에서 풀 리퀘스트, Skill 기여, 버그 리포트를 환영합니다.

OpenClaw는 AI와 상호작용하는 방식에 있어 진정한 변화를 나타냅니다 -- 조언을 구하는 것에서 실제 작업을 위임하는 것으로. 프로젝트는 빠르게 발전하고 있고, 커뮤니티는 성장하고 있으며, 여러분만의 AI 에이전트 환경을 구축하기 가장 좋은 때는 바로 지금입니다.