시작하기 (Getting Started)
기준일: 2026-06-06
난이도: 초급
공식 기준: OpenClaw Getting Started
OpenClaw는 다양한 채팅 앱과 AI 에이전트를 연결하는 self-hosted Gateway입니다. 현재 공식 빠른 시작은 설치 스크립트, onboarding wizard, Gateway 상태 확인, Control UI dashboard 순서로 진행합니다.
핵심 개념
| 개념 | 설명 |
|---|---|
| Gateway | 채널, 세션, 인증, dashboard를 연결하는 중심 프로세스 |
| Onboarding | 모델 provider, 인증, Gateway, 선택 채널을 설정하는 wizard |
| Dashboard | 브라우저에서 채팅과 설정을 확인하는 Control UI |
| Channel | Telegram, Discord, Slack 등 외부 메시징 표면 |
처음부터 채널을 연결하지 않아도 됩니다. 가장 빠른 첫 채팅은 openclaw dashboard로 Control UI를 여는 방식입니다.
선택 기준
| 시작 방식 | 추천 상황 |
|---|---|
| installer script | Node와 OpenClaw를 자동으로 준비하고 싶다 |
| npm/pnpm/bun | 이미 Node를 직접 관리한다 |
| local prefix installer | 시스템 전역 설치를 피하고 싶다 |
| source install | OpenClaw 자체를 개발하거나 패치한다 |
| dashboard first | 채널 설정 없이 첫 응답만 확인한다 |
빠른 시작
macOS, Linux, WSL2:
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard
Windows PowerShell:
iwr -useb https://openclaw.ai/install.ps1 | iex
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard
이미 Node를 직접 관리한다면:
npm install -g openclaw@latest
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard
시스템 요구사항
| 항목 | 기준 |
|---|---|
| Node.js | Node 24 권장 또는 Node 22.14 이상 |
| OS | macOS, Linux, Windows native 또는 WSL2 |
| pnpm | source build 때만 필요 |
| 네트워크 | provider 인증과 패키지 설치에 필요 |
OpenClaw에 입력할 프롬프트
내 OpenClaw 설치 상태를 점검해줘.
openclaw --version, doctor, gateway status, dashboard 접근 가능 여부를 기준으로
설치 문제와 Gateway 문제를 분리해서 알려줘.
체크리스트
-
openclaw --version이 실행된다. - onboarding을 실행했다.
-
openclaw gateway status로 Gateway 상태를 확인했다. -
openclaw dashboard또는http://127.0.0.1:18789/로 Control UI를 열었다. - 채널 연결 전 allowlist와 인증 방식을 검토했다.
섹션 개요
| 문서 | 내용 |
|---|---|
| 설치 가이드 | installer, npm/pnpm/bun, source 설치 |
| 기본 개념 | Gateway, Session, Agent, Channel |
| 첫 메시지 | Control UI 또는 채널에서 첫 응답 확인 |
| 트리거 | 메시지, 스케줄, 이벤트 트리거 |