설치 가이드

OpenClaw 시작하기

원하는 방식으로 설치하세요. 어떤 방법이든 같은 CLI를 사용합니다.

checklist 시스템 요구사항

javascript Node.js

Node.js 22 이상 (LTS 권장)

computer OS

Windows 10+, macOS 12+, 또는 Linux (Ubuntu 20.04+, Debian 11+)

memory RAM

최소 2 GB RAM, 4 GB 권장

hard_drive Disk

설치 및 의존성에 약 500 MB 디스크 공간

extension Optional

선택사항: Python 3.10+ (일부 스킬용), Git (소스 빌드용)

wifi Network

AI API 호출에 인터넷 연결 필요. Ollama를 통한 로컬 모델은 오프라인으로 작동합니다.

한 줄 명령어로 끝. 대부분의 사용자에게 추천. 문서에서 전체 내용 보기 arrow_forward

Windows (PowerShell)

관리자 권한으로 PowerShell을 실행하세요.

PS> curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd --tag beta && del install.cmd

macOS / Linux

macOS와 대부분의 Linux 배포판에서 작동합니다.

$ curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

verified 설치 확인

아래 명령어를 실행해서 OpenClaw가 올바르게 설치되었는지 확인하세요.

1
$ openclaw --version

설치된 버전 번호가 출력되어야 합니다 (예: v2026.3.12).

2
$ openclaw doctor

환경 진단을 실행합니다: Node.js 버전, 의존성, 설정 파일, 연결 상태를 확인합니다.

3
$ openclaw onboard

API 키, 채팅 플랫폼 연결, 초기 설정을 안내하는 대화형 설정 마법사입니다.

settings 초기 설정

설치 후 온보딩 마법사가 설정을 안내합니다. 각 단계가 하는 일은 다음과 같습니다.

1

AI 제공자 선택

Anthropic (Claude), OpenAI (GPT), Google (Gemini), 또는 Ollama를 통한 로컬 모델을 선택하세요. 설정에서 언제든 제공자를 변경할 수 있습니다.

2

API 키 추가

제공자 대시보드에서 API 키를 붙여넣으세요. 키는 로컬 .env 파일에 저장되며, AI 제공자 외에는 어디에도 전송되지 않습니다.

3

채팅 플랫폼 연결

WhatsApp (QR 코드 스캔), Telegram (@BotFather에서 봇 토큰 붙여넣기), Discord (봇 토큰 붙여넣기), 또는 다른 지원 플랫폼을 연결하세요.

4

테스트 메시지 보내기

연결된 채팅 앱을 통해 OpenClaw에 메시지를 보내보세요. 응답이 오면 설정 완료입니다. 이렇게 보내보세요: '뭘 할 수 있어?'

.env — 모든 설정은 ~/.openclaw/.env에 저장됩니다. 이 파일을 직접 편집해서 제공자 변경, API 키 추가, 설정 조정이 가능합니다. 전체 레퍼런스는 docs.openclaw.ai/configuration을 참고하세요.

system_update_alt OpenClaw 업그레이드

최신 기능, 연동, 보안 패치를 받으려면 OpenClaw를 최신 상태로 유지하세요. 업그레이드 & 마이그레이션 방법 arrow_forward

npm
$ npm update -g openclaw@latest
pnpm
$ pnpm update -g openclaw@latest
Git
$ cd openclaw && git pull && pnpm install && pnpm run build
Docker
$ docker pull openclaw/openclaw:latest && docker restart openclaw

각 버전의 변경사항은 github.com/openclaw/openclaw/releases에서 확인하세요.

delete_forever OpenClaw 제거하기

OpenClaw를 시스템에서 삭제하려면, 설치 방법에 맞는 단계를 따라 진행하세요. 삭제 방법 자세히 보기 arrow_forward

npm
$ npm uninstall -g openclaw
pnpm
$ pnpm remove -g openclaw
Git (Source)
$ rm -rf ~/openclaw
Docker
$ docker stop openclaw && docker rm openclaw && docker rmi openclaw/openclaw:latest

사용자 데이터 삭제 (선택 사항)

모든 대화 기록, 스킬, 설정, API 키가 삭제됩니다. 필요한 데이터는 미리 백업해 두세요.

macOS/Linux $ rm -rf ~/.openclaw
Windows PS> rmdir /s /q %USERPROFILE%\.openclaw

build 문제 해결

자주 발생하는 문제와 해결 방법입니다. 문제 해결 팁 더 보기 arrow_forward

도움이 필요하세요?

Discord에서 설치 지원을 받으세요.

forum Discord 참여 menu_book 설치 문서 전체 보기
hub 연동 • article 블로그 • apps 쇼케이스
❯

소식 받기

새 기능과 연동 소식을 알려드려요. 스팸 없음, 언제든 구독 취소 가능.