첫 단계
시작하기
OpenClaw를 설치하고, 온보딩을 실행한 다음, 약 5분 만에 AI 어시스턴트와 채팅하십시오. 완료하면 실행 중인 Gateway, 구성된 인증, 정상적으로 작동하는 채팅 세션을 갖추게 됩니다.
필요한 사항
- Node.js 22.22.3+, 24.15+ 또는 25.9+ (24가 권장 기본 버전입니다)
- 모델 제공업체(Anthropic, OpenAI, Google 등)의 API 키 — 온보딩 중에 입력하라는 메시지가 표시됩니다
빠른 설정
OpenClaw 설치
macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex온보딩 실행
openclaw onboard --install-daemon마법사가 모델 제공업체 선택, API 키 설정, Gateway 구성을 안내합니다. QuickStart는 일반적으로 몇 분밖에 걸리지 않지만, 제공업체 로그인, 채널 페어링, 데몬 설치, 네트워크 다운로드, Skills 또는 선택적 Plugin으로 인해 전체 온보딩에 더 오래 걸릴 수 있습니다. 선택적 단계를 건너뛰고 나중에 openclaw configure을 사용하여 다시 진행하십시오.
전체 참조 문서는 온보딩(CLI)을 참조하십시오.
Gateway 실행 여부 확인
openclaw gateway statusGateway가 포트 18789에서 수신 대기 중이라고 표시되어야 합니다.
대시보드 열기
openclaw dashboard브라우저에서 Control UI가 열립니다. 정상적으로 로드되면 모든 기능이 작동하는 것입니다.
첫 메시지 보내기
Control UI 채팅에 메시지를 입력하면 AI의 응답을 받을 수 있습니다.
휴대폰에서 채팅하고 싶습니까? 가장 빠르게 설정할 수 있는 채널은 Telegram입니다(봇 토큰만 필요합니다). 모든 옵션은 채널을 참조하십시오.
고급: 사용자 지정 Control UI 빌드 마운트
현지화하거나 사용자 지정한 대시보드 빌드를 유지 관리하는 경우, 빌드된 정적 자산과 index.html이 포함된 디렉터리를 gateway.controlUi.root으로 지정하십시오.
mkdir -p "$HOME/.openclaw/control-ui-custom"# 빌드한 정적 파일을 해당 디렉터리에 복사하십시오.그런 다음 다음과 같이 설정하십시오.
{"gateway": { "controlUi": { "enabled": true, "root": "$HOME/.openclaw/control-ui-custom" }}}Gateway를 다시 시작하고 대시보드를 다시 여십시오.
openclaw gateway restartopenclaw dashboard다음 단계
Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo 등을 지원합니다.
에이전트에게 메시지를 보낼 수 있는 사용자를 제어하십시오.
모델, 도구, 샌드박스 및 고급 설정입니다.
브라우저, 실행, 웹 검색, Skills 및 Plugin입니다.
고급: 환경 변수
OpenClaw를 서비스 계정으로 실행하거나 사용자 지정 경로를 사용하려는 경우:
OPENCLAW_HOME— 내부 경로 확인을 위한 홈 디렉터리OPENCLAW_STATE_DIR— 상태 디렉터리 재정의OPENCLAW_CONFIG_PATH— 구성 파일 경로 재정의
전체 참조 문서: 환경 변수.
