시작하기
목표: 최소한의 설정으로 첫 대화까지 빠르게 도달하기.
참고: 가장 빠른 방법: Control UI를 사용하면 채널 설정 없이 바로 대화할 수 있습니다.
openclaw dashboard를 실행하고 브라우저에서 채팅하거나, Gateway 호스트(OpenClaw Gateway 서비스가 실행 중인 머신)에서http://127.0.0.1:18789/를 열어보세요. 문서: 대시보드 및 Control UI.
사전 요구사항
- Node 24 권장 (Node 22 LTS, 현재
22.16+도 호환성을 위해 지원)
팁: Node 버전이 확실하지 않다면
node --version으로 확인하세요.
빠른 설정 (CLI)
1단계: OpenClaw 설치 (권장)
#### macOS/Linux
```bash
curl -fsSL https://openclaw.ai/install.sh | bash
```
<imgsrc=“https://cdn.openclaws.io/public/docs/assets/install-script.svg” alt=“Install Script Process” class=“rounded-lg” />
#### Windows (PowerShell)
```powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
```
> **참고:** 다른 설치 방법과 요구사항은 [설치](/docs/install)를 참고하세요.2단계: 온보딩 마법사 실행
```bash
openclaw onboard --install-daemon
```
마법사가 인증, Gateway 설정, 선택적 채널 구성을 안내합니다.
자세한 내용은 [온보딩 마법사](/docs/start/wizard)를 참고하세요.3단계: Gateway 확인
서비스를 설치했다면 이미 실행 중이어야 합니다:
```bash
openclaw gateway status
```4단계: Control UI 열기
```bash
openclaw dashboard
```확인: Control UI가 정상적으로 로드되면 Gateway가 준비된 것입니다.
추가 확인 및 옵션
Gateway를 포그라운드에서 실행하기
빠른 테스트나 문제 해결 시 유용합니다.
```bash
openclaw gateway --port 18789
```테스트 메시지 보내기
채널이 구성되어 있어야 합니다.
```bash
openclaw message send --target +15555550123 --message "Hello from OpenClaw"
```유용한 환경 변수
서비스 계정으로 OpenClaw를 실행하거나 설정/상태 저장 경로를 변경하고 싶을 때:
OPENCLAW_HOME은 내부 경로 해석에 사용할 홈 디렉토리를 설정합니다.OPENCLAW_STATE_DIR은 상태 디렉토리를 재정의합니다.OPENCLAW_CONFIG_PATH는 설정 파일 경로를 재정의합니다.
전체 환경 변수 레퍼런스: 환경 변수.
더 알아보기
- 온보딩 마법사 (상세) — CLI 마법사의 전체 레퍼런스와 고급 옵션.
- macOS 앱 온보딩 — macOS 앱의 최초 실행 흐름.
설정 완료 후 갖추게 되는 것
- 실행 중인 Gateway
- 인증 구성 완료
- Control UI 접속 또는 연결된 채널