6단계로 배포

OpenClaw 시작하기

이 단계를 따라 OpenClaw를 처음부터 설치하고 구성하세요

가장 빠른 경로

시험해보고 싶으신가요? 하나의 명령으로 대시보드를 시작하고 즉시 채팅할 수 있습니다:

$ openclaw dashboard

http://127.0.0.1:18789/

OpenClaw 요구 사항

시작하기 전에 시스템이 다음 요구 사항을 충족하는지 확인하세요

Node.js ≥ 22

OpenClaw 실행에 필요

운영 체제

macOS, Linux 또는 Windows(WSL2 권장)

Brave Search API(선택 사항)

웹 검색 기능 활성화

Windows

Windows 사용자는 호환성과 성능 향상을 위해 WSL2 사용을 강력히 권장합니다.

OpenClaw 설치

원하는 설치 방법을 선택하세요. 원라이너를 권장합니다

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

원라이너는 Node.js와 모든 종속성을 자동으로 감지하고 설치합니다. 수동 설정이 필요 없습니다.

OpenClaw 구성 마법사

마법사가 게이트웨이, 인증, 채팅 플랫폼 연결을 포함한 모든 필요한 설정을 안내합니다

$ openclaw onboard --install-daemon

마법사가 구성하는 항목

게이트웨이 유형 - 로컬 또는 원격 게이트웨이 선택
AI 모델 인증 - OpenAI(OAuth/API 키) 또는 Anthropic(API 키 권장, claude setup-token도 지원)
채팅 플랫폼 - WhatsApp QR 코드, Telegram/Discord 봇 토큰 등
데몬 서비스 - 백그라운드 서비스 설치(macOS: launchd, Linux/WSL2: systemd)

구성 파일 위치(중요)

기본 구성 디렉토리~/.openclaw/
OAuth 자격 증명~/.openclaw/credentials/oauth.json
인증 프로필(OAuth + API 키)~/.openclaw/agents/<agentId>/agent/auth-profiles.json

Claude Code가 설치되어 있으면 재구성 없이 claude setup-token을 통해 기존 자격 증명을 재사용할 수 있습니다.

헤드리스 서버 팁: 브라우저가 있는 머신에서 먼저 OAuth를 완료한 다음 oauth.json 파일을 서버의 해당 디렉토리로 복사하세요.

OpenClaw 게이트웨이 시작

게이트웨이는 모든 메시지를 처리하는 OpenClaw의 핵심 서비스입니다

서비스 상태 확인

$ openclaw gateway status

게이트웨이 수동 시작(포트 지정 시)

$ openclaw gateway --port 18789

웹 대시보드 액세스

http://127.0.0.1:18789/

빠른 확인(서비스 실행 중인지 확인)

$ openclaw status

$ openclaw health

$ openclaw security audit --deep

채팅 플랫폼 연결

첫 번째 채팅 인터페이스를 페어링하고 연결합니다

WhatsApp (QR 코드 로그인)

$ openclaw channels login

명령을 실행하여 QR 코드를 표시합니다. WhatsApp 열기 → 설정 → 연결된 기기 → QR 코드를 스캔하여 연결합니다.

전용 전화번호를 권장합니다. VoIP 번호는 권장되지 않습니다(차단되기 쉬움). 자격 증명은 ~/.openclaw/credentials/whatsapp/ 디렉토리에 저장됩니다.

Telegram / Discord / 기타

마법사가 토큰 구성을 도와줄 수 있습니다. 수동 설정을 선호하면 다음 문서를 참조하세요:

Telegram:문서 보기
Discord:문서 보기
Mattermost (플러그인):문서 보기

Telegram 팁: 첫 번째 DM은 페어링 코드를 반환합니다. 승인해야 합니다(다음 단계 참조). 그렇지 않으면 봇이 응답하지 않습니다.

OpenClaw 보안 설정

승인된 사용자만 AI 어시스턴트를 사용할 수 있도록 보장합니다

기본 동작: 알 수 없는 DM은 짧은 코드를 받고 승인될 때까지 메시지가 처리되지 않습니다. 첫 번째 DM에 응답이 없으면 페어링을 승인하세요:

대기 중인 페어링 요청 목록

$ openclaw pairing list whatsapp

페어링 승인([code]를 실제 코드로 교체)

$ openclaw pairing approve whatsapp <code>

이것은 무단 액세스를 방지하기 위한 중요한 보안 조치입니다. 구성 파일에서 허용 목록을 설정하여 특정 번호를 자동으로 허용할 수도 있습니다.

OpenClaw 확인

새 터미널에서 테스트 메시지를 보냅니다

테스트 메시지 보내기(대상 번호로 교체)

$ openclaw message send --target +15555550123 --message "Hello from OpenClaw"

openclaw health에서 "auth not configured"가 표시되면 마법사로 돌아가 OAuth/API 키 인증을 설정하세요. 설정하지 않으면 에이전트가 응답하지 않습니다.

디버그 팁

openclaw status --all복사-붙여넣기하기 좋은 읽기 전용 디버그 보고서
openclaw health또는openclaw status --deep실행 중인 게이트웨이에서 상태 스냅샷 요청

OpenClaw 설정 완료

축하합니다! OpenClaw를 성공적으로 설치하고 구성했습니다. 지금 바로 AI 어시스턴트와 채팅을 시작하세요.