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

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

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

📋 목차

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

---

1. 사전 준비물

# 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 생성

1. Discord Developer Portal 접속
2. "New Application" → 이름 입력
3. Bot 탭 → "Add Bot"
4. MESSAGE CONTENT INTENT 활성화 (필수!)
5. 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로 보내는 프롬프트 외에는 외부로 나가지 않습니다.

---

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