⏱️ 이름 변경 타임라인

⚠️ 주의: “클로드봇”, “몰트봇”은 모두 구 명칭이며, 현재는 “오픈클로(OpenClaw)”가 공식 명칭입니다. 온라인에서 이전 이름으로 검색하면 스캠 사이트나 가짜 프로젝트를 만날 수 있으니, 반드시 공식 GitHub 저장소(github.com/openclaw/openclaw)에서 다운로드하세요.

1. API 키 발급

오픈클로는 AI 모델 API를 통해 작동합니다. 다음 중 하나 이상의 API 키가 필요합니다:

• Anthropic Claude API (권장) – console.anthropic.com
• OpenAI GPT API – platform.openai.com
• Google Gemini API – ai.google.dev

💡 팁: Claude API 사용을 권장합니다. 월 $20 정도의 비용으로 충분히 사용 가능하며, 코딩 작업에 최적화되어 있습니다.

2. 메신저 계정 (선택)

오픈클로를 메신저로 제어하려면 다음 중 하나를 준비하세요:

• 텔레그램 – 봇 토큰 발급 필요 (@BotFather 이용)
• 디스코드 – 봇 애플리케이션 생성 필요
• 왓츠앱 – QR 코드 스캔 방식

3. 독립 실행 환경 (강력 권장)

보안을 위해 메인 PC가 아닌 별도 환경에서 실행을 권장합니다:

• Mac Mini – 24시간 가동 최적, 저전력, 조용함 (가장 인기)
• Raspberry Pi 5 – 저렴한 대안, 충분한 성능
• 클라우드 서버 – DigitalOcean, AWS EC2 등 (원클릭 배포 지원)

✅ 빠른 설치: 오픈클로는 원라인 설치 스크립트를 제공합니다. Node.js 등 모든 의존성을 자동으로 설치해줍니다.

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

Step 1: WSL2 설치

wsl --install -d Ubuntu

PowerShell을 관리자 권한으로 실행 후 위 명령어 입력 → 재부팅

Step 2: Ubuntu에서 오픈클로 설치

재부팅 후 Ubuntu 터미널을 열고:

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

openclaw start

⚠️ 권한 설정 주의: 처음에는 제한적인 권한으로 시작하고, 필요에 따라 점진적으로 확대하는 것을 권장합니다. 파일 삭제, 결제 등 중요한 작업은 반드시 사용자 승인을 요구하도록 설정하세요.

테스트 명령어:

• “안녕, 자기소개 해줘”
• “현재 시간이 몇 시야?”
• “간단한 텍스트 파일 하나 만들어줘”

✅ 응답이 정상적으로 오면 설치 성공!

Step 1: 텔레그램 봇 생성

1. 텔레그램에서 @BotFather 검색하여 대화 시작
2. /newbot 명령어 입력
3. 봇 이름 입력 (예: “My OpenClaw Bot”)
4. 봇 사용자명 입력 (예: “myopenclaw_bot”) – 반드시 “_bot”으로 끝나야 함
5. 발급받은 토큰 저장 (예: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz)

Step 2: 오픈클로 설정

openclaw messenger add telegram

프롬프트에서 토큰 입력 요청 시 앞서 발급받은 토큰을 붙여넣기

Step 3: 봇과 대화 시작

1. 텔레그램에서 생성한 봇을 검색 (예: @myopenclaw_bot)
2. /start 명령어로 봇 활성화
3. 이제 자유롭게 명령어를 보내보세요!

Step 1: 디스코드 봇 애플리케이션 생성

1. Discord Developer Portal 접속
2. “New Application” 클릭 → 이름 입력
3. 좌측 메뉴에서 “Bot” 선택 → “Add Bot” 클릭
4. “Reset Token” 클릭하여 토큰 생성 및 복사
5. “Privileged Gateway Intents”에서 모든 항목 활성화 (Message Content Intent 등)

Step 2: 봇을 서버에 초대

1. 좌측 메뉴 “OAuth2” → “URL Generator” 선택
2. SCOPES에서 “bot” 체크
3. BOT PERMISSIONS에서 “Administrator” 체크 (또는 필요한 권한만 선택)
4. 생성된 URL을 복사하여 브라우저에서 열기
5. 봇을 추가할 서버 선택 → 승인

Step 3: 오픈클로 설정

openclaw messenger add discord

토큰 입력 후, 디스코드 서버에서 봇을 멘션하여 명령 실행

🚨 중요: 오픈클로는 매우 강력한 권한을 가집니다

오픈클로는 파일 삭제, 명령 실행, 결제 등 실제 작업을 수행할 수 있습니다. 잘못 사용하면 시스템 손상, 데이터 유실, 금전적 피해가 발생할 수 있습니다. 반드시 다음 보안 수칙을 지켜주세요.

1. 독립된 환경에서 실행

• ✅ 권장: 메인 PC가 아닌 Mac Mini, Raspberry Pi, 클라우드 서버 사용
• ❌ 비권장: 중요한 개인 데이터가 있는 메인 컴퓨터에서 직접 실행
• 💡 이유: 혹시 모를 오작동 시 피해 최소화

2. 제한적인 권한으로 시작

• ✅ 특정 폴더만 접근 허용 (샌드박스)
• ✅ 중요 작업은 반드시 사용자 승인 요구
• ✅ 읽기 전용 권한부터 시작하여 점진적 확대
• ❌ 처음부터 전체 시스템 권한 부여

3. API 키 및 인증 정보 보호

• ✅ API 키를 환경 변수로 저장 (코드에 직접 작성 금지)
• ✅ 정기적으로 API 키 로테이션
• ✅ API 사용량 제한 설정 (비용 폭탄 방지)
• ❌ GitHub 등에 API 키 포함하여 커밋

4. 스킬 설치 시 코드 검토

• ⚠️ 커뮤니티 스킬 설치 전 반드시 코드 확인
• ⚠️ 악성 코드, 크립토 마이닝, 자격 증명 탈취 주의
• ✅ 신뢰할 수 있는 개발자의 검증된 스킬만 사용
• ✅ GitHub 스타 수, 리뷰, 업데이트 이력 확인

5. 웹 인터페이스 접근 제한

• ✅ localhost가 아닌 공개 IP로 노출 시 반드시 비밀번호 설정
• ✅ HTTPS 사용 (Let’s Encrypt 등)
• ✅ 방화벽으로 특정 IP만 접근 허용
• ❌ 인증 없이 공개 인터넷에 노출

6. 정기적인 로그 모니터링

• ✅ 오픈클로가 실행한 모든 명령 로그 확인
• ✅ 예상치 못한 동작 발견 시 즉시 중지
• ✅ 로그 자동 백업 및 보관

openclaw logs --tail 100

✅ 권장 설정: 오픈클로 공식 문서에서는 “완벽하게 안전한 설정은 없다”고 명시하고 있습니다. 가장 안전한 방법은 격리된 클라우드 서버나 별도 디바이스에서 실행하고, 중요한 작업은 항상 수동 승인을 받도록 설정하는 것입니다.

❓ 설치 스크립트가 실행되지 않아요

원인: 권한 부족 또는 네트워크 문제

해결:

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

또는 수동 설치: git clone https://github.com/openclaw/openclaw.git

❓ API 비용이 너무 많이 나와요

원인: 잦은 API 호출 또는 긴 컨텍스트 사용

해결:

• Anthropic Claude API 대신 로컬 LLM (Ollama) 사용
• API 호출 빈도 제한 설정
• 컨텍스트 길이 제한 (최대 토큰 수 설정)
• 월 예산 설정하여 자동 중단

❓ 텔레그램 봇이 응답하지 않아요

체크리스트:

• ✅ 오픈클로 프로세스가 실행 중인지 확인: openclaw status
• ✅ 토큰이 올바른지 재확인
• ✅ 봇과 대화에서 /start 명령어 입력했는지 확인
• ✅ 방화벽이 텔레그램 API 접근을 차단하는지 확인

❓ Windows에서 설치가 안 돼요

필수: WSL2가 반드시 설치되어 있어야 합니다

해결:

1. PowerShell 관리자 모드로 실행
2. wsl --install 실행 후 재부팅
3. Ubuntu 앱 실행하여 사용자 설정
4. Ubuntu 터미널에서 오픈클로 설치 스크립트 실행

❓ AI가 원하지 않는 작업을 실행했어요

긴급 중지:

openclaw stop
openclaw rollback --last

예방: 설정에서 “중요 작업 수동 승인” 활성화

⚠️ 주의: 강력한 권한을 가진 AI입니다. 보안 수칙을 반드시 준수하세요.