First steps
시작하기
OpenClaw을 설치하고, 온보딩을 실행한 다음, 약 5분 만에 AI 어시스턴트와 채팅해 보세요. 완료하면 실행 중인 Gateway, 구성된 인증, 정상적으로 작동하는 채팅 세션을 갖추게 됩니다.
필요한 항목
- Node.js 22.19+, 23.11+ 또는 24+(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를 구성합니다. 빠른 시작은 일반적으로 몇 분이면 완료되지만,
제공업체 로그인, 채널 페어링, 데몬 설치, 네트워크 다운로드, 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— 구성 파일 경로 재정의
전체 레퍼런스: 환경 변수.
