설치 가이드

OpenClaw 설정 방법 (단계별)

작동하는 OpenClaw를 위한 7단계. 모든 고통 포인트, 모든 단축키를 안내합니다.

OpenClaw 설정 7단계

이것은 실제 설정 과정입니다. 합산 조회수 300만 이상의 튜토리얼 영상과 실제로 해본 수천 명의 댓글을 기반으로 합니다.

하드웨어 선택

OpenClaw는 24시간 켜져 있는 컴퓨터가 필요합니다. 대부분의 사용자는 Mac Mini, DigitalOcean 또는 Hetzner의 VPS(월 $5-24), 또는 오래된 노트북을 사용합니다. Raspberry Pi는 가벼운 용도에 적합합니다. Docker는 VPS 배포에 권장되는 설치 방법이지만, 여러 댓글 작성자들이 Docker 설정만으로도 몇 시간이 걸렸다고 보고합니다.

ClawDaddy로 하면:

저희가 전용 서버를 프로비저닝합니다. 하드웨어 결정도, VPS 임대도, Docker도 필요 없습니다.

설치 명령어 실행

서버에 SSH로 접속하여 OpenClaw 인스톨러를 실행하세요. Mac에서는 openclaw.ai의 한 줄 명령어입니다. Linux VPS에서는 Docker Compose가 필요합니다. Windows 사용자들은 PowerShell 명령어가 처음에 실패한다고 보고합니다. 관리자 권한이 설치를 막을 수 있습니다. 한 댓글 작성자는 '지금까지 겪은 것 중 가장 짜증나는 일'이라고 표현했습니다.

ClawDaddy로 하면:

서버에 OpenClaw가 사전 설치되어 있습니다. 터미널 명령어가 전혀 필요 없습니다.

AI 모델 제공업체 선택

OpenClaw는 모델에 구애받지 않습니다. AI 백엔드를 선택하세요: Anthropic(Claude), OpenAI(GPT), Google(Gemini), 또는 Ollama를 통한 무료 로컬 모델. Claude Opus 4.6은 품질 면에서 커뮤니티 기본값입니다. Ollama는 비용을 절약하지만 출력 품질이 낮습니다. 한 사용자는 최근 업데이트가 호환성 문제를 해결하기 전까지 Ollama를 작동시키는 데 '어려움을 겪었다'고 보고했습니다.

ClawDaddy로 하면:

200개 이상의 모델이 사전 구성되어 있습니다. 대시보드에서 언제든지 전환하세요. $49 토큰 크레딧 포함.

API 키 생성 및 붙여넣기

AI 제공업체의 콘솔(예: console.anthropic.com)로 이동하여 새 API 키를 만들고 OpenClaw 설정에 붙여넣으세요. 지출 한도를 설정하세요. 실제 API 비용은 고사용 시 $10/일, 효율적인 모델인 GPT-4o-mini로는 훨씬 적게 듭니다. 일반적인 오류: 유효하지 않거나 만료된 키로 인한 'Error 400'.

ClawDaddy로 하면:

API 키가 필요 없습니다. 토큰 크레딧이 모든 플랜에 기본 포함되어 있습니다.

에이전트 정체성 설정

두 개의 마크다운 파일을 편집하세요: IDENTITY.md(에이전트가 누구인지, 무엇을 하는지)와 SOUL.md(행동 규칙, 어조, 피해야 할 것들). 이것들은 코드가 아닌 일반 텍스트 파일입니다. 재시작 없이 변경 사항이 즉시 적용됩니다. Windows에서는 일부 사용자들이 워크스페이스 폴더가 읽기 전용으로 고정되어 변경 사항을 저장할 수 없다고 보고합니다.

ClawDaddy로 하면:

채팅에서 ClawDaddy에게 에이전트의 이름과 성격을 알려주세요. 저희가 설정 파일을 작성합니다.

채팅 채널 연결

Telegram의 경우: BotFather를 열고, 새 봇을 만들고, 토큰을 복사하여 OpenClaw 설정에 붙여넣습니다. WhatsApp의 경우: QR 코드를 스캔합니다. 여러 사용자들이 WhatsApp 설정 중 'Config validation failed' 오류를 보고합니다. Telegram 플러그인은 게이트웨이를 재시작하기 전까지 '사용 불가'로 표시되기도 합니다. Discord와 Slack도 유사한 토큰 붙여넣기 방식을 따릅니다.

ClawDaddy로 하면:

웹 UI에서 가이드를 따른 채널 설정. Telegram은 기본으로 구성되어 있습니다.

테스트 및 라이브 전환

봇에게 메시지를 보내세요. 응답하면 라이브 상태입니다. 응답하지 않으면 게이트웨이 로그에서 오류를 확인하세요. 일반적인 문제: 모델 응답 없음, 몇 분 만에 레이트 리밋 도달, Docker VPS에서 플러그인 충돌. VPS 사용자 한 명은 초기 설치 후 '4일 중 2일을 문제 수정에 사용했다'고 보고했습니다. 재부팅 후에는 systemd 서비스를 설정하지 않았다면 OpenClaw 프로세스를 수동으로 재시작해야 합니다.

ClawDaddy로 하면:

배포 즉시 에이전트가 라이브 상태입니다. 매니지드 업타임, 자동 재시작, 유지 관리 없음.

직접 설정 vs ClawDaddy: 시간과 비용

마케팅 추정치가 아닌 실제 사용자의 실제 수치.

셀프 호스팅 (직접)

>하드웨어: 월 $5-24 VPS 또는 전용 Mac Mini

>설치: 30분에서 하루 종일 (Docker 문제)

>AI 모델 설정: 제공업체당 15-30분

>API 키 설정: 계정 생성, 키 관리, 한도 설정

>채널 설정: 30-60분 (BotFather, QR 코드, 유효성 검사 오류)

>보안: 방화벽, SSH 키, fail2ban (본인 책임)

>지속적인 유지 관리: 업데이트, 재부팅, 디버깅 (본인 직접)

>합계: 2-6시간 설정 + 지속적인 운영 시간

ClawDaddy 매니지드

하드웨어: 전용 서버 포함

설치: 사전 설치, 명령어 없음

AI 모델 설정: 200개 이상 모델, 사전 구성

API 키 설정: $49 토큰 크레딧 포함

채널 설정: 가이드 설정, Telegram 기본 포함

보안: 사전 강화, 자동 패치

지속적인 유지 관리: 매니지드 업데이트, 자동 재시작, 일일 백업

합계: 5분 이내, 이후 완전 자동

설정 FAQ

OpenClaw 설정에 코딩 지식이 필요한가요?

셀프 호스팅의 경우: 기본적인 터미널 사용에 익숙하면 도움이 됩니다. 설치 명령어를 실행하고 텍스트 파일을 편집합니다. 실제 프로그래밍은 필요 없습니다. OpenClaw 설정은 코드가 아닌 일반 마크다운입니다. 하지만 여러 초보자들이 터미널 개념에서 막힌다고 보고합니다. ClawDaddy는 터미널 지식이 전혀 필요 없습니다.

일반 Windows PC에서 OpenClaw를 실행할 수 있나요?

가능합니다만 불편함을 예상하세요. PowerShell 명령어가 처음에 실패할 수 있습니다. 워크스페이스 폴더가 읽기 전용으로 고정될 수 있습니다. Windows의 Docker Desktop은 고유한 문제가 있습니다. 대부분의 튜토리얼 영상은 macOS만 다룹니다. Linux VPS 또는 Mac Mini가 더 원활한 경로입니다.

최소 VPS 요구 사항은 무엇인가요?

vCPU 2개, RAM 4GB, SSD 40GB면 OpenClaw를 무리 없이 실행할 수 있습니다. 대부분의 제공업체에서 월 $5-10짜리 VPS입니다. OpenClaw와 함께 Ollama를 통해 로컬 모델을 실행할 계획이라면 더 많은 RAM이 필요합니다 (최소 8GB, 권장 16GB).

Docker로 실행해야 하나요, 아니면 직접 설치해야 하나요?

Docker는 VPS 배포에 공식적으로 권장되는 방법입니다. 의존성을 격리하고 업데이트를 더 쉽게 만듭니다. 하지만 Docker 설정은 영상 댓글에서 불만 1위이기도 합니다. macOS에서의 직접 설치는 더 간단합니다 (한 줄 명령어). 프로덕션 VPS에는 Docker를, 로컬 Mac 테스트에는 직접 설치를 선택하세요.

컴퓨터를 재부팅하면 어떻게 되나요?

설정하지 않으면 OpenClaw는 재부팅 후 자동으로 시작되지 않습니다. Mac에서는 launch agent가 필요합니다. Linux에서는 systemd 서비스를 설정하세요. Docker에서는 재시작 정책을 사용하세요. 이 단계를 놓치면 기기가 재시작될 때마다 에이전트가 오프라인 상태가 됩니다. ClawDaddy는 이를 자동으로 처리합니다.

'Error 400' 또는 'config validation failed'를 어떻게 수정하나요?

'Error 400'은 일반적으로 설정의 유효하지 않은 API 키 또는 잘못된 모델 이름을 의미합니다. 키가 활성화되어 있고 만료되지 않았으며 제공업체와 일치하는지 확인하세요. WhatsApp의 'Config validation failed'는 채널 설정 JSON의 형식 오류를 의미하는 경우가 많습니다. 쉼표나 따옴표가 누락되었는지 확인하세요. 게이트웨이 로그에서 실패한 정확한 필드를 확인할 수 있습니다.

Docker를 사용한 VPS에서 OpenClaw가 안정적인가요?

작동하지만 유지 관리를 예상하세요. 장기 VPS 사용자 한 명은 플러그인 충돌과 Docker 문제를 해결하는 데 4일 중 2일을 사용했다고 보고했습니다. 보안 패치는 수동으로 적용해야 합니다. 업데이트가 플러그인을 손상시키는 경우가 있습니다. 각 OpenClaw 릴리스마다 경험이 향상되고 있지만, 셀프 호스팅 Docker는 설정하고 잊어버릴 수 있는 수준이 아닙니다.

레이트 리밋은 어떻게 처리하나요? 에이전트가 몇 분 만에 소진해버려요.

API 제공업체 대시보드에서 지출 한도를 설정하세요. 일상 업무에는 비용 효율적인 모델(GPT-4o-mini, Claude Haiku)을 사용하고 복잡한 작업에만 고가 모델을 예약하세요. OpenClaw는 모델 라우팅을 지원합니다. 다른 작업에 다른 모델을 할당할 수 있습니다. ClawDaddy의 경우 월 $49의 토큰 크레딧으로 200개 이상의 모델에서 일반적인 사용량을 충당합니다.

설정 과정을 완전히 건너뛰세요

ClawDaddy는 5분 이내에 전용 서버에 OpenClaw를 배포합니다. Docker도, 터미널도, API 키 관리도 없습니다. 200개 이상의 모델과 $49 토큰 크레딧이 포함됩니다.

지금 OpenClaw 배포하기