🦞 OpenClaw 완벽 가이드 #2 — 설치부터 첫 대화까지 (실전 셋업)

OpenClaw 완벽 가이드 #2: 설치 & 셋업

이론은 충분합니다. 이제 직접 설치하고, 메신저에서 AI와 대화해봅시다.

📋 목차

사전 준비물
OpenClaw 설치
LLM Provider 설정
첫 번째 채널 연결 (Discord)
SOUL.md로 성격 커스텀
첫 대화 테스트
자주 묻는 질문 (FAQ)

1. 사전 준비물

항목	설명
Node.js	v20 이상 (v22+ 권장)
OS	macOS, Linux, Windows (WSL)
LLM API Key	Anthropic, OpenAI, 또는 Google 중 하나
메신저 봇 토큰	Discord Bot Token, Telegram Bot Token 등

# Node.js 버전 확인
node --version  # v20.0.0 이상이어야 합니다

2. OpenClaw 설치

# npm으로 글로벌 설치
npm install -g openclaw

# 설치 확인
openclaw --version

# 초기 설정 (대화형 온보딩)
openclaw onboard --install-daemon

openclaw onboard를 실행하면 대화형으로 기본 설정을 안내합니다:

LLM Provider 선택
API 키 입력
워크스페이스 디렉토리 설정
시스템 데몬 등록

3. LLM Provider 설정

OpenClaw는 거의 모든 LLM을 지원합니다:

# 예시: Anthropic Claude 설정
ai:
  provider: anthropic
  model: claude-sonnet-4-5
  apiKey: sk-ant-xxxx...

모델 추천:

💰 가성비: Claude Sonnet 4.5 (일상 대화용)
🧠 고성능: Claude Opus 4.6 (복잡한 작업)
🆓 무료: Google Gemini Flash (실험용)

팁: 평소엔 Sonnet으로 쓰다가, 중요한 작업만 /model opus로 전환하면 비용을 90% 줄일 수 있습니다.

4. 첫 번째 채널 연결 (Discord)

4-1. Discord Bot 생성

Discord Developer Portal 접속
"New Application" → 이름 입력
Bot 탭 → "Add Bot"
MESSAGE CONTENT INTENT 활성화 (필수!)
Token 복사

4-2. 서버에 봇 초대

OAuth2 → URL Generator에서:

Scopes: bot, applications.commands
Permissions: Send Messages, Read Message History, Manage Threads

4-3. OpenClaw 설정에 추가

channels:
  discord:
    token: "YOUR_BOT_TOKEN"
    allowlist:
      - id: "YOUR_CHANNEL_ID"
        requireMention: false

4-4. Gateway 시작

openclaw gateway start

5. SOUL.md로 성격 커스텀

워크스페이스에 SOUL.md를 만들면 에이전트의 성격이 됩니다:

# SOUL.md
당신은 "블리코"입니다.
- 한국어로 대화합니다
- 존댓말을 쓰되, 편안하고 장난기 있게
- 기술적 질문엔 정확하고 간결하게
- 불필요한 인사말은 생략합니다

다른 유용한 파일들:

USER.md — 사용자 정보 (MBTI, 선호 등)
TOOLS.md — 로컬 환경 노트
MEMORY.md — 장기 기억 저장소

6. 첫 대화 테스트

Discord에서 설정한 채널로 가서 메시지를 보내보세요:

"안녕! 오늘 날씨 어때?"

OpenClaw가 웹을 검색해서 날씨를 알려줄 겁니다. 축하합니다! 🎉

추가로 해볼 것들:

"내 워크스페이스 파일 목록 보여줘"
"10분 후에 알려줘: 물 마시기"
"이 URL 요약해줘: https://..."

7. 자주 묻는 질문 (FAQ)

Q: 비용이 얼마나 드나요? A: OpenClaw 자체는 무료 오픈소스입니다. LLM API 비용만 발생하며, Sonnet 기준 하루 활발히 써도 $1-3 수준입니다.

Q: 항상 켜놔야 하나요? A: 네, Gateway가 실행 중이어야 메시지를 받을 수 있습니다. Mac Mini나 라즈베리 파이에서 24/7 운영하는 분이 많습니다.

Q: 여러 메신저를 동시에 쓸 수 있나요? A: 네! Discord + Telegram + WhatsApp 등 동시 연결 가능합니다. 같은 에이전트가 모든 채널에서 응답합니다.

Q: 내 데이터는 안전한가요? A: 모든 데이터는 로컬에만 저장됩니다. LLM Provider로 보내는 프롬프트 외에는 외부로 나가지 않습니다.

다음 글에서는 보안 위험과 리스크에 대해 솔직하게 다룹니다. 🦞