컨텐츠로 건너뛰기
OpenClaw 완벽 가이드

체크리스트 PDF (프린트용)

프린트용 페이지: 이 페이지를 출력하여 설치/보안 체크리스트로 사용하세요.

설치 전 체크리스트

시스템 요구사항 확인

  • Node.js 22+ 설치 (node --version)
  • 4GB+ RAM 사용 가능
  • 2GB+ 디스크 여유 공간
  • 인터넷 연결 확인
  • 관리자/설치 권한 확인

계정 준비

  • OpenAI/Anthropic API 키 준비
  • (선택) GitHub 계정
  • (선택) Telegram BotFather 봇 생성
  • (선택) Slack 앱 생성 권한

보안 계획

  • 설치 환경 결정 (WSL2/Docker/네이티브)
  • 민감 데이터 분리 계획
  • 네트워크 격리 여부 결정
  • 백업 계획 수립

설치 체크리스트

macOS

  • Xcode Command Line Tools 설치
  • (선택) Homebrew 설치
  • Node.js 22+ 설치
  • OpenClaw 설치: npm install -g openclaw@latest
  • 온보딩 실행: openclaw onboard --install-daemon
  • 상태 확인: openclaw doctor
  • 대시보드 접속 확인

Linux (Ubuntu/Debian)

  • 시스템 업데이트: sudo apt update && sudo apt upgrade
  • build-essential 설치
  • Node.js 22+ 설치
  • OpenClaw 설치
  • 온보딩 실행
  • (선택) systemd 서비스 등록
  • 방화벽 설정 (포트 18789)

Windows (WSL2)

  • WSL2 활성화
  • Ubuntu 22.04 설치
  • Ubuntu 초기 설정
  • Node.js 설치
  • OpenClaw 설치
  • 온보딩 실행
  • Windows Terminal 설정

보안 체크리스트 (필수)

설치 단계

  • WSL2/Docker/별도 서버로 격리 설치
  • 전용 사용자 계정으로 실행
  • sudo/root 권한 불필요 확인
  • .openclaw 디렉토리 권한 확인 (700)

설정 단계

  • DM 정책을 pairing으로 설정
  • Gateway 인증 활성화
  • API 키를 환경 변수 또는 보안 저장소에 저장
  • .env 파일을 .gitignore에 추가

스킬 설치 전

  • GitHub 저장소 확인
  • 코드 리뷰 (index.ts/js 확인)
  • 권한 요구사항 검토
  • 최근 업데이트 확인 (6개월 이내)
  • 이슈 트래커 확인

스킬 설치 후

  • 샌드박스에서 테스트
  • 네트워크 트래픽 모니터링
  • 로그 확인
  • 불필요한 권한 제거

정기 점검 (주간/월간)

  • 설치된 스킬 목록 검토
  • API 키 사용량 확인
  • 로그 이상 유무 확인
  • API 키 회전 (분기별)
  • 백업 확인

실행 체크리스트

첫 실행

  • Gateway 상태 확인: openclaw status
  • Doctor 진단: openclaw doctor
  • 대시보드 접속: openclaw dashboard
  • 테스트 메시지 전송

채널 연결

  • Telegram 봇 토큰 입력
  • Telegram DM 페어링 설정
  • 테스트 메시지 수신 확인
  • (선택) Slack 연동
  • (선택) Discord 연동

기본 테스트

  • 간단한 대화 테스트
  • 파일 전송 테스트
  • 웹 검색 테스트 (스킬 설치 시)
  • 이메일 테스트 (스킬 설치 시)

문제 해결 체크리스트

설치 문제

  • Node.js 버전 확인 (22+)
  • npm 전역 경로 확인
  • PATH 설정 확인
  • 방화벽 설정 확인

실행 문제

  • 포트 충돌 확인 (lsof -i :18789)
  • 설정 파일 유효성 확인
  • 로그 확인 (openclaw logs)
  • 프로세스 중복 실행 확인

연결 문제

  • Gateway 실행 상태 확인
  • 네트워크 연결 확인
  • 인증 토큰 확인
  • 채널 설정 확인

모델 설정 체크리스트

Anthropic Claude

  • API 키 유효성 확인
  • 크레딧 잔액 확인
  • 모델 선택 (Sonnet/Opus)
  • Rate limit 확인

OpenAI

  • API 키 유효성 확인
  • 결제 정보 등록
  • 사용량 한도 설정
  • 모델 선택 (GPT-4o/GPT-4o-mini)

폴오버 설정

  • 기본 모델 설정
  • 백업 모델 설정
  • 폴오버 조건 테스트
  • 장애 시 알림 설정

문서화 체크리스트

개인 메모

  • API 키 저장 위치 기록
  • 설정 변경사항 기록
  • 설치한 스킬 목록 작성
  • 커스텀 설정 백업

팀 공유 (해당 시)

  • 설정 문서화
  • 권한 문서화
  • 보안 정책 공유
  • 장애 대응 문서

최종 확인

설치 완료 후 반드시 확인:

  • OpenClaw가 정상적으로 실행됨
  • 대시보드에 접속 가능함
  • 메신저로 대화가 가능함
  • 보안 설정이 적용됨
  • 백업이 완료됨

출력일: _______________
확인자: _______________