OpenClaw란 무엇인가?
OpenClaw는 자신의 컴퓨터에서 실행되는 오픈소스 AI 에이전트입니다. 클라우드에 존재하며 대화만 할 수 있는 ChatGPT나 Claude.ai와 달리, OpenClaw는 여러분의 기기에 존재하며 행동할 수 있습니다 — 파일 관리, 메시지 전송, 웹 브라우징, 스마트 홈 기기 제어, 스케줄에 따른 자동화 실행 등이 가능합니다.
이미 사용하고 있는 채팅 앱을 통해 상호작용합니다: WhatsApp, Telegram, Discord, Slack, iMessage 등. 항상 켜져 있고, 항상 학습하며, 항상 당신의 것입니다.
필요한 것
- •컴퓨터: Mac, Windows (WSL2 포함), 또는 Linux. Raspberry Pi도 가능합니다.
- •Node.js 22 이상: OpenClaw는 Node.js에서 실행됩니다.
- •AI API 키: Anthropic (Claude), OpenAI (GPT), 또는 Ollama를 통한 로컬 모델.
- •10분: 정말로 그것만 있으면 됩니다.
1단계: Node.js 설치
Node.js 22+가 없다면, nvm (Node Version Manager)을 통해 설치하세요:
# macOS / Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
# Windows (use nvm-windows from github.com/coreybutler/nvm-windows)
nvm install 22
nvm use 22
확인: node --version이 v22.x.x 이상을 표시해야 합니다.
2단계: OpenClaw 설치
npm install -g openclaw@latest
또는 pnpm으로:
pnpm add -g openclaw@latest
확인: openclaw --version이 설치된 버전을 출력해야 합니다.
3단계: 온보딩 마법사 실행
openclaw onboard --install-daemon
마법사가 다음을 안내합니다:
- 1.API 키 설정: Anthropic 또는 OpenAI API 키를 붙여넣기하세요. 로컬 모델을 사용하려면 나중에 Ollama를 구성할 수 있습니다.
- 2.채팅 플랫폼: 처음 연결할 메시징 앱을 선택하세요. WhatsApp이 가장 인기 있는 선택입니다 — QR 코드를 스캔하여 계정을 연결합니다.
- 3.데몬 설치: 데몬은 터미널을 닫은 후에도 OpenClaw가 백그라운드에서 계속 실행되도록 합니다.
4단계: 인사하기
연결된 채팅 앱(WhatsApp, Telegram 등)을 열고 에이전트에게 메시지를 보내세요:
> 안녕! 무엇을 할 수 있어?
에이전트가 자신의 기능 요약으로 응답할 것입니다. 몇 가지를 시도해보세요:
- •"도쿄의 현재 시간은?"
- •"이 기사 요약해줘: [URL 붙여넣기]"
- •"내일 오후 6시에 엄마에게 전화하라고 알려줘"
- •"최신 OpenClaw 릴리스 검색해줘"
5단계: 에이전트 맞춤화
성격 설정
~/.openclaw/agents/default/SOUL.md를 편집하여 에이전트의 톤과 규칙을 정의하세요. 예시:
You are a helpful, concise assistant. Always confirm before deleting files or sending messages.
스킬 설치
스킬은 에이전트에게 새로운 능력을 부여하는 플러그인입니다:
openclaw skill install web-search
openclaw skill install home-assistant
openclaw skill install github-integration
ClawHub 마켓플레이스에서 사용 가능한 스킬을 둘러보세요.
웹 UI 접근
OpenClaw에는 로컬 웹 대시보드가 포함되어 있습니다:
openclaw ui
이것은 대화 기록 보기, 스킬 관리, 에이전트 활동 모니터링, 설정 조정을 할 수 있는 브라우저 인터페이스를 엽니다.
아키텍처 이해
You (phone/laptop)
|
v
Chat Platform (WhatsApp, Telegram, Discord...)
|
v
OpenClaw Gateway (runs on your machine)
|
v
AI Model (Claude, GPT, Ollama, etc.)
|
v
Skills & Tools (file system, web, APIs, smart home...)
메시지는 채팅 앱에서 여러분의 기기에 있는 OpenClaw 게이트웨이로 전달됩니다. 게이트웨이는 추론을 위해 AI 모델에 메시지를 보낸 다음 설치된 스킬을 사용하여 행동을 실행합니다. 응답은 같은 경로를 통해 되돌아갑니다.
AI 모델 추론을 제외하고 모든 것이 로컬에서 실행됩니다 (로컬 모델에 Ollama를 사용하지 않는 한).
첫 주 일반적인 질문
"왜 에이전트의 응답이 느린가요?" 콜드 스타트 후 첫 응답은 AI 모델이 컨텍스트를 로드하는 동안 몇 초가 걸립니다. 같은 대화의 후속 메시지는 더 빠릅니다. 응답이 지속적으로 느리다면 AI 제공업체와의 인터넷 연결을 확인하세요.
"비용이 얼마나 드나요?" 가벼운 사용(하루에 몇 번의 대화)은 일반적으로 API 요금으로 월 $10-30이 듭니다. Claude Haiku나 로컬 모델을 간단한 작업에 사용하면 비용을 크게 줄일 수 있습니다.
"여러 채팅 앱을 동시에 사용할 수 있나요?" 네. OpenClaw는 WhatsApp, Telegram, Discord 및 기타 플랫폼에 동시에 연결할 수 있습니다. 모든 플랫폼의 메시지는 같은 에이전트가 처리합니다.
"안전한가요?" OpenClaw는 여러분의 기기에서 실행되며 모든 데이터를 여러분이 제어합니다. 최신 상태를 유지하고, 설치 전 스킬을 검토하며, docs.openclaw.ai/security의 보안 가이드를 따르세요.
다음 단계
- •SOUL.md 가이드를 읽고 에이전트의 성격을 맞춤화하세요
- •스킬 마켓플레이스에서 새로운 기능을 탐색하세요
- •Discord 커뮤니티에 참여하여 도움과 영감을 받으세요
- •공식 문서에서 고급 구성을 확인하세요
OpenClaw 커뮤니티에 오신 것을 환영합니다. 당신의 랍스터가 준비되었습니다.