OpenClaw Guide: Build Your AI Assistant

요약 (TL;DR)

OpenClaw는 GitHub 스타 13.5만 개 이상을 보유한 오픈 소스 AI 어시스턴트입니다.
사용자의 기기에서 로컬로 실행되므로 데이터 프라이버시가 보장됩니다.
WhatsApp, Telegram, Discord, Slack, iMessage 등과 연결 가능합니다.
자동화, 코딩, 스마트 홈 등을 위한 3,000개 이상의 커뮤니티 스킬을 제공합니다.
무료입니다 (AI API 토큰 비용만 발생하며, 일반적으로 월 $10-50 수준입니다).
이 가이드를 따라 하면 설치에 약 30분이 소요됩니다.

OpenClaw란 무엇인가요?

OpenClaw(이전 명칭 Clawdbot, 이후 Moltbot)는 2026년 가장 핫한 오픈 소스 AI 프로젝트입니다. 다음과 같은 기능을 갖춘 개인용 AI 어시스턴트입니다.

사용자의 컴퓨터 또는 서버에서 실행됩니다.
즐겨 사용하는 메시징 앱(WhatsApp, Telegram, Discord 등)과 연결됩니다.
사용자의 파일 시스템, 터미널 및 브라우저에 대한 전체 액세스 권한을 가집니다.
개인 비서처럼 작업을 자동화할 수 있습니다.

나만의 자비스(Jarvis)를 갖는다고 생각해보세요. 파일을 검색하고, 명령어를 실행하고, 이메일을 보내고, 스마트 홈 기기를 제어하는 등 컴퓨터에서 할 수 있는 거의 모든 일을 수행할 수 있는 AI입니다.

명칭의 변화: Clawdbot → Moltbot → OpenClaw

이 프로젝트는 다음과 같은 명칭 변경 과정을 거쳤습니다.

날짜	이름	사유
2025년 11월	Clawdbot	제작자 Peter Steinberger가 정한 원래 이름
2025년 12월	Moltbot	Anthropic의 상표권 요청으로 변경
2026년 1월	OpenClaw	독립성을 위한 커뮤니티 브랜드 재편

이름에 관계없이 로컬에서 실행되는 매우 강력한 AI 어시스턴트라는 기능은 동일합니다.

왜 OpenClaw인가요?

vs. ChatGPT / Claude 웹 버전

기능	ChatGPT/Claude	OpenClaw
로컬 실행	❌	✅
파일 액세스	❌	✅
터미널 명령어 실행	❌	✅
컴퓨터 제어	❌	✅
WhatsApp 연동	❌	✅
데이터 프라이버시	클라우드 기반	100% 로컬
스킬 확장성	제한적	3,000개 이상의 스킬

vs. 기타 AI 에이전트

OpenClaw만의 독보적인 특징:

멀티 채널 인박스: WhatsApp, Telegram, Discord, Slack, iMessage 등 12개 이상의 플랫폼에서 하나의 AI에 접속 가능
지속적 메모리: 대화 전반에 걸친 컨텍스트 기억
스킬 생태계: ClawHub를 통해 3,000개 이상의 커뮤니티 플러그인 제공
모델 독립성: Claude, GPT, Gemini, DeepSeek, 로컬 Ollama 모델 등과 연동
오픈 소스: MIT 라이선스, 완전히 검증 가능한 코드

사전 준비 사항

시작하기 전에 다음 사항을 확인하세요.

[ ] 컴퓨터 (Mac, WSL2가 설치된 Windows, 또는 Linux)
[ ] Node.js v22+ 설치됨 (여기서 다운로드)
[ ] AI API 키 (Anthropic Claude, OpenAI 등)
[ ] 약 30분의 시간

하드웨어 요구 사양

구성	RAM	저장 공간	비고
최소 사양	4GB	1GB	기본 기능 작동
권장 사양	8GB+	2GB+	원활한 환경
로컬 모델 사용 시	16GB+	50GB+	Ollama 실행용

설치 방법

방법 1: 한 줄 설치 (권장)

가장 빠르게 시작하는 방법입니다.

bash

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

이 스크립트는 다음 과정을 수행합니다.

시스템 요구 사항 확인

OpenClaw 설치

온보딩 마법사 실행

방법 2: Docker (서버 권장)

컨테이너화된 배포를 선호하는 경우:

bash

# 리포지토리 클론
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Docker 설정 실행
./docker-setup.sh

Docker 설정은 다음 두 개의 중요한 디렉토리를 생성합니다.

~/.openclaw/ — 설정, 메모리, API 키

~/openclaw/workspace/ — AI 에이전트가 액세스할 수 있는 파일

방법 3: 소스에서 빌드

전체 제어 권한을 원하는 개발자용:

bash

# 리포지토리 클론
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 의존성 설치
pnpm install

# UI 빌드
pnpm ui:build

# 프로젝트 빌드
pnpm build

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

단계별 설정 가이드

1단계: 온보딩 마법사 실행

설치 후 온보딩 마법사가 자동으로 실행됩니다. 실행되지 않는 경우 다음 명령어를 입력하세요.

bash

openclaw onboard --install-daemon

마법사는 다음 과정을 안내합니다.

모델 제공업체 선택
API 키 설정
메시징 플랫폼 설정
보안 설정

2단계: AI 모델 설정

OpenClaw는 여러 AI 제공업체를 지원합니다. 하나를 선택하세요.

옵션 A: Anthropic Claude (권장)

bash

# API 키 설정
export ANTHROPIC_API_KEY=sk-ant-xxxxx

# 또는 config 명령어 사용
openclaw config set 'models.default' 'claude-sonnet-4'

옵션 B: OpenAI

bash

export OPENAI_API_KEY=sk-xxxxx
openclaw config set 'models.default' 'gpt-4o'

옵션 C: DeepSeek (가성비 선택)

bash

openclaw config set 'models.providers.deepseek' --json '{
  "baseUrl": "https://api.deepseek.com/v1",
  "apiKey": "your-api-key",
  "api": "openai-completions",
  "models": [
    { "id": "deepseek-chat", "name": "DeepSeek Chat" },
    { "id": "deepseek-reasoner", "name": "DeepSeek Reasoner" }
  ]
}'

옵션 D: Ollama를 이용한 로컬 모델

완벽한 프라이버시를 위해 모델을 로컬에서 실행하세요.

bash

# 먼저 Ollama 설치: https://ollama.ai
ollama pull llama3.3

# OpenClaw가 이를 사용하도록 설정
openclaw config set 'models.providers.ollama' --json '{
  "baseUrl": "http://localhost:11434/v1",
  "api": "openai-completions",
  "models": [
    { "id": "llama3.3", "name": "Llama 3.3" }
  ]
}'

3단계: 메시징 플랫폼 연결

어디서나 AI와 채팅할 수 있다는 점이 OpenClaw의 가장 큰 장점입니다.

Telegram (가장 쉬움)

Telegram에서 @BotFather에게 메시지 전송
/newbot을 보내고 안내에 따름
봇 토큰(Bot Token) 복사
OpenClaw 설정:

bash

openclaw config set 'channels.telegram.token' 'YOUR_BOT_TOKEN'
openclaw config set 'channels.telegram.allowlist' '["your_telegram_username"]'

OpenClaw는 연결을 위해 WhatsApp Web을 사용합니다.

bash

# WhatsApp 채널 활성화
openclaw config set 'channels.whatsapp.enabled' true

# 게이트웨이 재시작
openclaw gateway restart

# 나타나는 QR 코드 스캔

터미널에 QR 코드가 나타납니다. 휴대폰의 WhatsApp에서 스캔하세요(설정 → 연결된 기기 → 기기 연결).

Discord

discord.com/developers에서 Discord 애플리케이션 생성
봇을 생성하고 토큰 복사
설정:

bash

openclaw config set 'channels.discord.token' 'YOUR_BOT_TOKEN'
openclaw config set 'channels.discord.allowlist' '["your_discord_user_id"]'

iMessage (Mac 전용)

Mac 사용자의 경우 OpenClaw를 iMessage에 직접 연결할 수 있습니다.

bash

openclaw config set 'channels.imessage.enabled' true

4단계: 게이트웨이 시작

게이트웨이는 OpenClaw를 계속 실행 상태로 유지하는 백그라운드 서비스입니다.

bash

# 데몬(백그라운드 서비스)으로 시작
openclaw gateway start

# 또는 디버깅을 위해 포그라운드에서 실행
openclaw gateway

# 상태 확인
openclaw gateway status

# 로그 확인
openclaw logs --follow

5단계: 웹 대시보드 접속

OpenClaw에는 설정 및 직접 채팅을 위한 웹 인터페이스가 포함되어 있습니다.

bash

# 브라우저에서 대시보드 열기
openclaw dashboard

임시 로그인 토큰과 함께 http://127.0.0.1:18789/가 열립니다.

대시보드에서 다음을 할 수 있습니다.

AI와 직접 채팅

설정 관리

대화 기록 보기

스킬 설치

첫 번째 대화

모든 설정이 완료되면 봇에게 메시지를 보내보세요 (Telegram, WhatsApp 또는 웹 UI 사용).

안녕! 네가 할 수 있는 일들을 알려줘.

OpenClaw가 자신과 자신의 기능을 소개할 것입니다. 실제 작업도 요청해보세요.

내 다운로드 폴더에 어떤 파일들이 있어?

내 문서에서 "2025년 세금"과 관련된 내용을 찾아줘.

CSV를 JSON으로 변환하는 Python 스크립트를 만들어줘.

내 컴퓨터에서 디스크 공간을 가장 많이 차지하는 게 뭐야?

스킬 설치하기

스킬을 통해 OpenClaw의 기능을 확장할 수 있습니다. ClawHub 레지스트리를 탐색하거나 직접 설치하세요.

스킬 카테고리

카테고리	인기 스킬	활용 사례
개발자	github, gitlab, jira, linear	PR 리뷰, 이슈 관리
생산성	calendar, email, notion, todoist	일정 예약, 작업 관리
자동화	agent-browser, puppeteer, selenium	웹 스크래핑, 폼 입력
스마트 홈	homeassistant, philips-hue, tuya	조명 제어, 장면 실행
금융	crypto-prices, stock-tracker	포트폴리오 모니터링
미디어	spotify, youtube-dl, plex	음악 제어, 다운로드

보안 경고

⚠️ 중요: 스킬을 설치하기 전에 검토하세요. ClawHub의 개방성으로 인해 악성 스킬이 존재할 수 있습니다. openclaw skill inspect 을 사용하여 코드를 검토하거나, Claude Code / Codex에 감수를 요청하세요.

고급 설정

설정 파일 구조

OpenClaw는 설정을 ~/.openclaw/에 저장합니다.

~/.openclaw/
├── openclaw.json    # 메인 설정
├── env              # 환경 변수 (API 키)
├── memory/          # 지속적 메모리 저장소
├── skills/          # 설치된 스킬
├── backups/         # 설정 백업
└── logs/            # 로그 파일

설정 편집

bash

# 현재 설정 보기
openclaw config get

# 값 설정
openclaw config set 'key.path' 'value'

# 기본 에디터에서 편집
openclaw config edit

메모리 관리

OpenClaw는 대화 전반에 걸쳐 지속적인 메모리를 유지합니다.

bash

# 메모리 통계 보기
openclaw memory stats

# 모든 메모리 삭제 (주의!)
openclaw memory clear

# 백업을 위해 메모리 내보내기
openclaw memory export > memory-backup.json

상태 점검(Health Check) 실행

bash

# 종합 상태 점검
openclaw doctor

# 특정 구성 요소 점검
openclaw doctor --check api
openclaw doctor --check channels
openclaw doctor --check skills

보안 베스트 프랙티스

OpenClaw는 전체 시스템 액세스 권한을 가집니다. 이는 매우 강력하지만 위험할 수도 있습니다. 다음 가이드라인을 따르세요.

1. 전용 머신 사용

주 작업용 컴퓨터에서 OpenClaw를 실행하지 않는 것이 좋습니다. 대안:

VPS: DigitalOcean, Vultr, AWS (월 $5-20)
오래된 노트북: 구형 하드웨어 재활용
Raspberry Pi: 가벼운 용도로 적합
Docker: 어느 정도의 격리 환경 제공

2. 샌드박스 모드 활성화

신뢰할 수 없는 세션(그룹 채팅, 채널 등)의 경우:

bash

openclaw config set 'agents.defaults.sandbox.mode' 'non-main'

이렇게 설정하면 그룹/채널 세션이 Docker 샌드박스 내에서 실행됩니다.

3. 허용 목록(Allowlist) 사용

특정 사용자만 봇과 상호작용할 수 있도록 제한하세요.

bash

# Telegram
openclaw config set 'channels.telegram.allowlist' '["username1", "username2"]'

# Discord
openclaw config set 'channels.discord.allowlist' '["user_id_1", "user_id_2"]'

4. 최신 상태 유지

이전 버전에서 보안 취약점이 발견된 바 있습니다. 항상 최신 버전을 실행하세요.

bash

# 업데이트 확인
openclaw update --check

# 최신으로 업데이트
openclaw update

참고: 2026.1.29 이전 버전에는 알려진 보안 취약점이 있습니다. 이전 버전을 사용 중이라면 즉시 업데이트하세요.

5. 설치 전 스킬 검토

bash

# 스킬 코드 검사
openclaw skill inspect <skill-name>

# 스킬 평판 확인
openclaw skill info <skill-name>

자동화 예시

OpenClaw가 진가를 발휘하는 부분입니다.

모닝 브리핑

매일 오전 8시에 요약 정보를 받도록 설정하세요.

bash

# 설정에 크론(cron) 작업 추가
openclaw config set 'automations.morning-briefing' --json '{
  "cron": "0 8 * * *",
  "action": "일기 예보, 오늘의 캘린더 일정, 읽지 않은 중요한 이메일, 주요 뉴스 헤드라인 3개를 요약해서 보내줘"
}'

GitHub PR 리뷰 봇

PR이 할당되면 자동으로 리뷰하도록 설정합니다.

bash

openclaw skill install github

# 웹훅 또는 폴링 설정
openclaw config set 'automations.pr-review' --json '{
  "trigger": "github.pr.assigned",
  "action": "PR을 리뷰하고 버그, 보안 문제, 스타일 위반 사항을 확인해줘. 요약 댓글을 작성해."
}'

스마트 홈 장면(Scene)

bash

openclaw skill install homeassistant

# "외출" 자동화
openclaw config set 'automations.leaving-home' --json '{
  "trigger": "location.leave_home",
  "action": "모든 조명을 끄고 테모스탯을 에코 모드로 설정하고 보안 시스템을 작동시켜줘"
}'

파일 정리

OpenClaw에게 다운로드 폴더 정리를 시켜보세요.

내 다운로드 폴더를 정리해줘: 이미지는 ~/Pictures로, 문서는 ~/Documents로 이동시키고 30일보다 오래된 파일은 삭제해줘.

문제 해결

일반적인 문제

"Command not found: openclaw"

bash

# PATH에 추가
export PATH="$HOME/.openclaw/bin:$PATH"
# 쉘 프로필(.bashrc, .zshrc)에 추가하세요.

"API key invalid"

bash

# 환경 변수 확인
openclaw config get models

# 온보딩 다시 실행
openclaw onboard

"WhatsApp QR 코드가 나타나지 않음"

bash

# 로그 확인
openclaw logs --channel whatsapp

# 게이트웨이 재시작
openclaw gateway restart

"스킬이 로드되지 않음"

bash

# 스킬 인덱스 재구축
openclaw skill rebuild

# 충돌 확인
openclaw doctor --check skills

도움받기

공식 문서: docs.openclaw.ai
GitHub Issues: github.com/openclaw/openclaw/issues
Discord 커뮤니티: discord.gg/openclaw
Reddit: r/OpenClaw

비용 분석

OpenClaw 자체는 무료입니다. 비용은 AI API 사용량에 따라 발생합니다.

사용 수준	월간 토큰	예상 비용
가벼운 사용	~100만 토큰	$3-10
보통 사용	~500만 토큰	$15-40
많은 사용	~2,000만 토큰	$60-150
파워 유저	5,000만+ 토큰	$150+

비용 절감 팁

루틴한 작업에는 DeepSeek 사용 (Claude의 $3/M 대비 $0.14/M 수준)
단순한 쿼리에는 로컬 모델 사용 (하드웨어 준비 후 무료)
대화당 토큰 제한 설정
반복되는 쿼리에는 캐싱 사용

다음 단계는?

이제 OpenClaw가 실행 중이므로 다음 아이디어들을 시도해볼 수 있습니다.

나만의 스킬 만들기

특정 요구 사항에 맞는 커스텀 스킬을 만드세요.

bash

# 새 스킬 생성
openclaw skill create my-custom-skill

# 스킬 편집
code ~/.openclaw/skills/my-custom-skill/SKILL.md

더 많은 플랫폼 연결

여러 개의 WhatsApp 계정 추가 (개인용 + 업무용)
업무용 Slack, 개인용 Discord 연결
Apple 생태계를 위한 iMessage 설정

생태계 탐색

3,000개 이상의 스킬이 있는 ClawHub 방문
팁과 트릭을 공유하는 Discord 커뮤니티 가입
업데이트 소식을 위해 @OpenClaw 팔로우

한 걸음 더: 나만의 AI 제품 배포하기

AI 어시스턴트의 강력함을 경험했다면, 다른 사람들을 위한 제품을 만들고 싶어질 수도 있습니다. 바로 여기서 Y Build가 도움을 드릴 수 있습니다.

Y Build는 AI 기반 아이디어를 실제 제품으로 출시할 수 있도록 돕습니다.

AI 코딩: 원하는 것을 설명하면 AI가 코드를 생성합니다.
원클릭 배포: 글로벌 CDN을 통해 즉시 라이브로 전환하세요.
성장 도구: 데모 비디오, SEO 최적화, 분석 도구를 제공합니다.

다음과 같은 제품을 만들고 싶으신가요?

AI 기반 SaaS 툴
OpenClaw와 같은 자동화 플랫폼
비즈니스용 커스텀 챗봇

Y Build가 배포와 성장을 책임지는 동안 여러분은 빌드에만 집중하세요. Y Build 무료 체험하기 →

결론

OpenClaw는 개인용 AI의 새로운 패러다임을 보여줍니다.

로컬: 데이터가 사용자 기기를 떠나지 않습니다.
강력함: 시스템 전체 권한을 통한 실질적인 자동화가 가능합니다.
확장성: 3,000개 이상의 스킬이 있으며 계속 늘어나고 있습니다.
멀티 플랫폼: 하나의 AI를 어디서나 사용할 수 있습니다.

30분 만에 여러분은 다음과 같은 일을 할 수 있는 나만의 AI 어시스턴트를 갖게 되었습니다.

WhatsApp에서 질문에 답하기
파일 검색 및 정리
반복적인 작업 자동화
스마트 홈 제어
그 외 수많은 작업

AI의 미래는 클라우드의 챗봇만이 아닙니다. 여러분의 인프라에서 실행되고 여러분의 통제 하에 있는 개인용 AI 에이전트입니다.

OpenClaw 커뮤니티에 오신 것을 환영합니다. 🦞

출처:

요약 (TL;DR)

OpenClaw는 GitHub 스타 13.5만 개 이상을 보유한 오픈 소스 AI 어시스턴트입니다.
사용자의 기기에서 로컬로 실행되므로 데이터 프라이버시가 보장됩니다.
WhatsApp, Telegram, Discord, Slack, iMessage 등과 연결 가능합니다.
자동화, 코딩, 스마트 홈 등을 위한 3,000개 이상의 커뮤니티 스킬을 제공합니다.
무료입니다 (AI API 토큰 비용만 발생하며, 일반적으로 월 $10-50 수준입니다).
이 가이드를 따라 하면 설치에 약 30분이 소요됩니다.

OpenClaw란 무엇인가요?

OpenClaw(이전 명칭 Clawdbot, 이후 Moltbot)는 2026년 가장 핫한 오픈 소스 AI 프로젝트입니다. 다음과 같은 기능을 갖춘 개인용 AI 어시스턴트입니다.

사용자의 컴퓨터 또는 서버에서 실행됩니다.
즐겨 사용하는 메시징 앱(WhatsApp, Telegram, Discord 등)과 연결됩니다.
사용자의 파일 시스템, 터미널 및 브라우저에 대한 전체 액세스 권한을 가집니다.
개인 비서처럼 작업을 자동화할 수 있습니다.

명칭의 변화: Clawdbot → Moltbot → OpenClaw

이 프로젝트는 다음과 같은 명칭 변경 과정을 거쳤습니다.

날짜	이름	사유
2025년 11월	Clawdbot	제작자 Peter Steinberger가 정한 원래 이름
2025년 12월	Moltbot	Anthropic의 상표권 요청으로 변경
2026년 1월	OpenClaw	독립성을 위한 커뮤니티 브랜드 재편

이름에 관계없이 로컬에서 실행되는 매우 강력한 AI 어시스턴트라는 기능은 동일합니다.

왜 OpenClaw인가요?

vs. ChatGPT / Claude 웹 버전

기능	ChatGPT/Claude	OpenClaw
로컬 실행	❌	✅
파일 액세스	❌	✅
터미널 명령어 실행	❌	✅
컴퓨터 제어	❌	✅
WhatsApp 연동	❌	✅
데이터 프라이버시	클라우드 기반	100% 로컬
스킬 확장성	제한적	3,000개 이상의 스킬

vs. 기타 AI 에이전트

OpenClaw만의 독보적인 특징:

멀티 채널 인박스: WhatsApp, Telegram, Discord, Slack, iMessage 등 12개 이상의 플랫폼에서 하나의 AI에 접속 가능
지속적 메모리: 대화 전반에 걸친 컨텍스트 기억
스킬 생태계: ClawHub를 통해 3,000개 이상의 커뮤니티 플러그인 제공
모델 독립성: Claude, GPT, Gemini, DeepSeek, 로컬 Ollama 모델 등과 연동
오픈 소스: MIT 라이선스, 완전히 검증 가능한 코드

사전 준비 사항

시작하기 전에 다음 사항을 확인하세요.

[ ] 컴퓨터 (Mac, WSL2가 설치된 Windows, 또는 Linux)
[ ] Node.js v22+ 설치됨 (여기서 다운로드)
[ ] AI API 키 (Anthropic Claude, OpenAI 등)
[ ] 약 30분의 시간

하드웨어 요구 사양

구성	RAM	저장 공간	비고
최소 사양	4GB	1GB	기본 기능 작동
권장 사양	8GB+	2GB+	원활한 환경
로컬 모델 사용 시	16GB+	50GB+	Ollama 실행용

설치 방법

방법 1: 한 줄 설치 (권장)

가장 빠르게 시작하는 방법입니다.

bash

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

이 스크립트는 다음 과정을 수행합니다.

시스템 요구 사항 확인

OpenClaw 설치

온보딩 마법사 실행

방법 2: Docker (서버 권장)

컨테이너화된 배포를 선호하는 경우:

bash

# 리포지토리 클론
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Docker 설정 실행
./docker-setup.sh

Docker 설정은 다음 두 개의 중요한 디렉토리를 생성합니다.

~/.openclaw/ — 설정, 메모리, API 키

~/openclaw/workspace/ — AI 에이전트가 액세스할 수 있는 파일

방법 3: 소스에서 빌드

전체 제어 권한을 원하는 개발자용:

bash

# 리포지토리 클론
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 의존성 설치
pnpm install

# UI 빌드
pnpm ui:build

# 프로젝트 빌드
pnpm build

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

단계별 설정 가이드

1단계: 온보딩 마법사 실행

설치 후 온보딩 마법사가 자동으로 실행됩니다. 실행되지 않는 경우 다음 명령어를 입력하세요.

bash

openclaw onboard --install-daemon

마법사는 다음 과정을 안내합니다.

모델 제공업체 선택
API 키 설정
메시징 플랫폼 설정
보안 설정

2단계: AI 모델 설정

OpenClaw는 여러 AI 제공업체를 지원합니다. 하나를 선택하세요.

옵션 A: Anthropic Claude (권장)

bash

# API 키 설정
export ANTHROPIC_API_KEY=sk-ant-xxxxx

# 또는 config 명령어 사용
openclaw config set 'models.default' 'claude-sonnet-4'

옵션 B: OpenAI

bash

export OPENAI_API_KEY=sk-xxxxx
openclaw config set 'models.default' 'gpt-4o'

옵션 C: DeepSeek (가성비 선택)

bash

openclaw config set 'models.providers.deepseek' --json '{
  "baseUrl": "https://api.deepseek.com/v1",
  "apiKey": "your-api-key",
  "api": "openai-completions",
  "models": [
    { "id": "deepseek-chat", "name": "DeepSeek Chat" },
    { "id": "deepseek-reasoner", "name": "DeepSeek Reasoner" }
  ]
}'

옵션 D: Ollama를 이용한 로컬 모델

완벽한 프라이버시를 위해 모델을 로컬에서 실행하세요.

bash

# 먼저 Ollama 설치: https://ollama.ai
ollama pull llama3.3

# OpenClaw가 이를 사용하도록 설정
openclaw config set 'models.providers.ollama' --json '{
  "baseUrl": "http://localhost:11434/v1",
  "api": "openai-completions",
  "models": [
    { "id": "llama3.3", "name": "Llama 3.3" }
  ]
}'

3단계: 메시징 플랫폼 연결

어디서나 AI와 채팅할 수 있다는 점이 OpenClaw의 가장 큰 장점입니다.

Telegram (가장 쉬움)

Telegram에서 @BotFather에게 메시지 전송
/newbot을 보내고 안내에 따름
봇 토큰(Bot Token) 복사
OpenClaw 설정:

bash

openclaw config set 'channels.telegram.token' 'YOUR_BOT_TOKEN'
openclaw config set 'channels.telegram.allowlist' '["your_telegram_username"]'

OpenClaw는 연결을 위해 WhatsApp Web을 사용합니다.

bash

# WhatsApp 채널 활성화
openclaw config set 'channels.whatsapp.enabled' true

# 게이트웨이 재시작
openclaw gateway restart

# 나타나는 QR 코드 스캔

터미널에 QR 코드가 나타납니다. 휴대폰의 WhatsApp에서 스캔하세요(설정 → 연결된 기기 → 기기 연결).

Discord

discord.com/developers에서 Discord 애플리케이션 생성
봇을 생성하고 토큰 복사
설정:

bash

openclaw config set 'channels.discord.token' 'YOUR_BOT_TOKEN'
openclaw config set 'channels.discord.allowlist' '["your_discord_user_id"]'

iMessage (Mac 전용)

Mac 사용자의 경우 OpenClaw를 iMessage에 직접 연결할 수 있습니다.

bash

openclaw config set 'channels.imessage.enabled' true

4단계: 게이트웨이 시작

게이트웨이는 OpenClaw를 계속 실행 상태로 유지하는 백그라운드 서비스입니다.

bash

# 데몬(백그라운드 서비스)으로 시작
openclaw gateway start

# 또는 디버깅을 위해 포그라운드에서 실행
openclaw gateway

# 상태 확인
openclaw gateway status

# 로그 확인
openclaw logs --follow

5단계: 웹 대시보드 접속

OpenClaw에는 설정 및 직접 채팅을 위한 웹 인터페이스가 포함되어 있습니다.

bash

# 브라우저에서 대시보드 열기
openclaw dashboard

임시 로그인 토큰과 함께 http://127.0.0.1:18789/가 열립니다.

대시보드에서 다음을 할 수 있습니다.

AI와 직접 채팅

설정 관리

대화 기록 보기

스킬 설치

첫 번째 대화

모든 설정이 완료되면 봇에게 메시지를 보내보세요 (Telegram, WhatsApp 또는 웹 UI 사용).

안녕! 네가 할 수 있는 일들을 알려줘.

OpenClaw가 자신과 자신의 기능을 소개할 것입니다. 실제 작업도 요청해보세요.

내 다운로드 폴더에 어떤 파일들이 있어?

내 문서에서 "2025년 세금"과 관련된 내용을 찾아줘.

CSV를 JSON으로 변환하는 Python 스크립트를 만들어줘.

내 컴퓨터에서 디스크 공간을 가장 많이 차지하는 게 뭐야?

스킬 설치하기

스킬을 통해 OpenClaw의 기능을 확장할 수 있습니다. ClawHub 레지스트리를 탐색하거나 직접 설치하세요.

스킬 카테고리

카테고리	인기 스킬	활용 사례
개발자	github, gitlab, jira, linear	PR 리뷰, 이슈 관리
생산성	calendar, email, notion, todoist	일정 예약, 작업 관리
자동화	agent-browser, puppeteer, selenium	웹 스크래핑, 폼 입력
스마트 홈	homeassistant, philips-hue, tuya	조명 제어, 장면 실행
금융	crypto-prices, stock-tracker	포트폴리오 모니터링
미디어	spotify, youtube-dl, plex	음악 제어, 다운로드

보안 경고

⚠️ 중요: 스킬을 설치하기 전에 검토하세요. ClawHub의 개방성으로 인해 악성 스킬이 존재할 수 있습니다. openclaw skill inspect 을 사용하여 코드를 검토하거나, Claude Code / Codex에 감수를 요청하세요.

고급 설정

설정 파일 구조

OpenClaw는 설정을 ~/.openclaw/에 저장합니다.

~/.openclaw/
├── openclaw.json    # 메인 설정
├── env              # 환경 변수 (API 키)
├── memory/          # 지속적 메모리 저장소
├── skills/          # 설치된 스킬
├── backups/         # 설정 백업
└── logs/            # 로그 파일

설정 편집

bash

# 현재 설정 보기
openclaw config get

# 값 설정
openclaw config set 'key.path' 'value'

# 기본 에디터에서 편집
openclaw config edit

메모리 관리

OpenClaw는 대화 전반에 걸쳐 지속적인 메모리를 유지합니다.

bash

# 메모리 통계 보기
openclaw memory stats

# 모든 메모리 삭제 (주의!)
openclaw memory clear

# 백업을 위해 메모리 내보내기
openclaw memory export > memory-backup.json

상태 점검(Health Check) 실행

bash

# 종합 상태 점검
openclaw doctor

# 특정 구성 요소 점검
openclaw doctor --check api
openclaw doctor --check channels
openclaw doctor --check skills

보안 베스트 프랙티스

OpenClaw는 전체 시스템 액세스 권한을 가집니다. 이는 매우 강력하지만 위험할 수도 있습니다. 다음 가이드라인을 따르세요.

1. 전용 머신 사용

주 작업용 컴퓨터에서 OpenClaw를 실행하지 않는 것이 좋습니다. 대안:

VPS: DigitalOcean, Vultr, AWS (월 $5-20)
오래된 노트북: 구형 하드웨어 재활용
Raspberry Pi: 가벼운 용도로 적합
Docker: 어느 정도의 격리 환경 제공

2. 샌드박스 모드 활성화

신뢰할 수 없는 세션(그룹 채팅, 채널 등)의 경우:

bash

openclaw config set 'agents.defaults.sandbox.mode' 'non-main'

이렇게 설정하면 그룹/채널 세션이 Docker 샌드박스 내에서 실행됩니다.

3. 허용 목록(Allowlist) 사용

특정 사용자만 봇과 상호작용할 수 있도록 제한하세요.

bash

# Telegram
openclaw config set 'channels.telegram.allowlist' '["username1", "username2"]'

# Discord
openclaw config set 'channels.discord.allowlist' '["user_id_1", "user_id_2"]'

4. 최신 상태 유지

이전 버전에서 보안 취약점이 발견된 바 있습니다. 항상 최신 버전을 실행하세요.

bash

# 업데이트 확인
openclaw update --check

# 최신으로 업데이트
openclaw update

참고: 2026.1.29 이전 버전에는 알려진 보안 취약점이 있습니다. 이전 버전을 사용 중이라면 즉시 업데이트하세요.

5. 설치 전 스킬 검토

bash

# 스킬 코드 검사
openclaw skill inspect <skill-name>

# 스킬 평판 확인
openclaw skill info <skill-name>

자동화 예시

OpenClaw가 진가를 발휘하는 부분입니다.

모닝 브리핑

매일 오전 8시에 요약 정보를 받도록 설정하세요.

bash

# 설정에 크론(cron) 작업 추가
openclaw config set 'automations.morning-briefing' --json '{
  "cron": "0 8 * * *",
  "action": "일기 예보, 오늘의 캘린더 일정, 읽지 않은 중요한 이메일, 주요 뉴스 헤드라인 3개를 요약해서 보내줘"
}'

GitHub PR 리뷰 봇

PR이 할당되면 자동으로 리뷰하도록 설정합니다.

bash

openclaw skill install github

# 웹훅 또는 폴링 설정
openclaw config set 'automations.pr-review' --json '{
  "trigger": "github.pr.assigned",
  "action": "PR을 리뷰하고 버그, 보안 문제, 스타일 위반 사항을 확인해줘. 요약 댓글을 작성해."
}'

스마트 홈 장면(Scene)

bash

openclaw skill install homeassistant

# "외출" 자동화
openclaw config set 'automations.leaving-home' --json '{
  "trigger": "location.leave_home",
  "action": "모든 조명을 끄고 테모스탯을 에코 모드로 설정하고 보안 시스템을 작동시켜줘"
}'

파일 정리

OpenClaw에게 다운로드 폴더 정리를 시켜보세요.

내 다운로드 폴더를 정리해줘: 이미지는 ~/Pictures로, 문서는 ~/Documents로 이동시키고 30일보다 오래된 파일은 삭제해줘.

문제 해결

일반적인 문제

"Command not found: openclaw"

bash

# PATH에 추가
export PATH="$HOME/.openclaw/bin:$PATH"
# 쉘 프로필(.bashrc, .zshrc)에 추가하세요.

"API key invalid"

bash

# 환경 변수 확인
openclaw config get models

# 온보딩 다시 실행
openclaw onboard

"WhatsApp QR 코드가 나타나지 않음"

bash

# 로그 확인
openclaw logs --channel whatsapp

# 게이트웨이 재시작
openclaw gateway restart

"스킬이 로드되지 않음"

bash

# 스킬 인덱스 재구축
openclaw skill rebuild

# 충돌 확인
openclaw doctor --check skills

도움받기

공식 문서: docs.openclaw.ai
GitHub Issues: github.com/openclaw/openclaw/issues
Discord 커뮤니티: discord.gg/openclaw
Reddit: r/OpenClaw

비용 분석

OpenClaw 자체는 무료입니다. 비용은 AI API 사용량에 따라 발생합니다.

사용 수준	월간 토큰	예상 비용
가벼운 사용	~100만 토큰	$3-10
보통 사용	~500만 토큰	$15-40
많은 사용	~2,000만 토큰	$60-150
파워 유저	5,000만+ 토큰	$150+

비용 절감 팁

루틴한 작업에는 DeepSeek 사용 (Claude의 $3/M 대비 $0.14/M 수준)
단순한 쿼리에는 로컬 모델 사용 (하드웨어 준비 후 무료)
대화당 토큰 제한 설정
반복되는 쿼리에는 캐싱 사용

다음 단계는?

이제 OpenClaw가 실행 중이므로 다음 아이디어들을 시도해볼 수 있습니다.

나만의 스킬 만들기

특정 요구 사항에 맞는 커스텀 스킬을 만드세요.

bash

# 새 스킬 생성
openclaw skill create my-custom-skill

# 스킬 편집
code ~/.openclaw/skills/my-custom-skill/SKILL.md

더 많은 플랫폼 연결

여러 개의 WhatsApp 계정 추가 (개인용 + 업무용)
업무용 Slack, 개인용 Discord 연결
Apple 생태계를 위한 iMessage 설정

생태계 탐색

3,000개 이상의 스킬이 있는 ClawHub 방문
팁과 트릭을 공유하는 Discord 커뮤니티 가입
업데이트 소식을 위해 @OpenClaw 팔로우

한 걸음 더: 나만의 AI 제품 배포하기

AI 어시스턴트의 강력함을 경험했다면, 다른 사람들을 위한 제품을 만들고 싶어질 수도 있습니다. 바로 여기서 Y Build가 도움을 드릴 수 있습니다.

Y Build는 AI 기반 아이디어를 실제 제품으로 출시할 수 있도록 돕습니다.

AI 코딩: 원하는 것을 설명하면 AI가 코드를 생성합니다.
원클릭 배포: 글로벌 CDN을 통해 즉시 라이브로 전환하세요.
성장 도구: 데모 비디오, SEO 최적화, 분석 도구를 제공합니다.

다음과 같은 제품을 만들고 싶으신가요?

AI 기반 SaaS 툴
OpenClaw와 같은 자동화 플랫폼
비즈니스용 커스텀 챗봇

Y Build가 배포와 성장을 책임지는 동안 여러분은 빌드에만 집중하세요. Y Build 무료 체험하기 →

결론

OpenClaw는 개인용 AI의 새로운 패러다임을 보여줍니다.

로컬: 데이터가 사용자 기기를 떠나지 않습니다.
강력함: 시스템 전체 권한을 통한 실질적인 자동화가 가능합니다.
확장성: 3,000개 이상의 스킬이 있으며 계속 늘어나고 있습니다.
멀티 플랫폼: 하나의 AI를 어디서나 사용할 수 있습니다.

30분 만에 여러분은 다음과 같은 일을 할 수 있는 나만의 AI 어시스턴트를 갖게 되었습니다.

WhatsApp에서 질문에 답하기
파일 검색 및 정리
반복적인 작업 자동화
스마트 홈 제어
그 외 수많은 작업

AI의 미래는 클라우드의 챗봇만이 아닙니다. 여러분의 인프라에서 실행되고 여러분의 통제 하에 있는 개인용 AI 에이전트입니다.

OpenClaw 커뮤니티에 오신 것을 환영합니다. 🦞

출처:

요약 (TL;DR)

OpenClaw란 무엇인가요?

명칭의 변화: Clawdbot → Moltbot → OpenClaw

왜 OpenClaw인가요?

vs. ChatGPT / Claude 웹 버전

vs. 기타 AI 에이전트

사전 준비 사항

하드웨어 요구 사양

설치 방법

방법 1: 한 줄 설치 (권장)

방법 2: Docker (서버 권장)

방법 3: 소스에서 빌드

단계별 설정 가이드

1단계: 온보딩 마법사 실행

2단계: AI 모델 설정

옵션 A: Anthropic Claude (권장)

옵션 B: OpenAI

옵션 C: DeepSeek (가성비 선택)

옵션 D: Ollama를 이용한 로컬 모델

3단계: 메시징 플랫폼 연결

Telegram (가장 쉬움)

WhatsApp

Discord

iMessage (Mac 전용)

4단계: 게이트웨이 시작

5단계: 웹 대시보드 접속

첫 번째 대화

스킬 설치하기

인기 스킬

스킬 카테고리

보안 경고

고급 설정

설정 파일 구조

설정 편집

메모리 관리

상태 점검(Health Check) 실행

보안 베스트 프랙티스

1. 전용 머신 사용

2. 샌드박스 모드 활성화

3. 허용 목록(Allowlist) 사용

4. 최신 상태 유지

5. 설치 전 스킬 검토

자동화 예시

모닝 브리핑

GitHub PR 리뷰 봇

스마트 홈 장면(Scene)

파일 정리

문제 해결

일반적인 문제

도움받기

비용 분석

비용 절감 팁

다음 단계는?

나만의 스킬 만들기

더 많은 플랫폼 연결

생태계 탐색

한 걸음 더: 나만의 AI 제품 배포하기

결론

요약 (TL;DR)

OpenClaw란 무엇인가요?

명칭의 변화: Clawdbot → Moltbot → OpenClaw

왜 OpenClaw인가요?

vs. ChatGPT / Claude 웹 버전

vs. 기타 AI 에이전트

사전 준비 사항

하드웨어 요구 사양

설치 방법

방법 1: 한 줄 설치 (권장)

방법 2: Docker (서버 권장)

방법 3: 소스에서 빌드

단계별 설정 가이드

1단계: 온보딩 마법사 실행

2단계: AI 모델 설정

옵션 A: Anthropic Claude (권장)

옵션 B: OpenAI

옵션 C: DeepSeek (가성비 선택)

옵션 D: Ollama를 이용한 로컬 모델

3단계: 메시징 플랫폼 연결

Telegram (가장 쉬움)

WhatsApp