시작하기 (Getting Started)

기준일: 2026-07-14 난이도: 초급
공식 기준: OpenClaw Docs, Getting Started, Documentation Index

OpenClaw는 다양한 채팅 앱과 AI 에이전트를 연결하는 self-hosted Gateway입니다. 현재 공식 빠른 시작은 installer 또는 openclaw@latest, 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 권장, 지원 범위는 22.22.3+, 24.15+, 25.9+
OS	macOS, Linux, Windows native 또는 WSL2
pnpm	source build 때만 필요
네트워크	provider 인증과 패키지 설치에 필요

Windows 사용자는 native Windows Hub app이 가장 쉬운 데스크톱 경로입니다. PowerShell installer와 WSL2 Gateway 경로도 공식 문서에서 함께 안내합니다.

공식 문서 기준 학습 경로

목표	먼저 볼 영역	이 사이트의 문서
첫 응답 확인	Install, Onboarding, Control UI	설치, 첫 메시지
메신저 연결	Channels, Pairing, Access groups, Routing	채널 개요, 접근 제어와 라우팅
반복 업무	Scheduled tasks, Heartbeat, Hooks	자동화 개요, Cron, Heartbeat
장기 운영	Gateway, Security, Configuration, Troubleshooting	Gateway 운영, 보안, 설정
확장	Skills, Plugins, Nodes, Providers	스킬, ClawHub, Nodes와 플랫폼

공식 인덱스에는 개별 메신저 외에도 background tasks, Task Flow, standing orders, ambient room events, bot loop protection처럼 운영 시 놓치기 쉬운 항목이 있습니다. 처음부터 모두 설정하지 말고 채널 접근 제어와 Gateway 보안을 먼저 안정화한 뒤 자동화와 확장을 추가합니다.

도구에 입력할 프롬프트

내 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 또는 채널에서 첫 응답 확인
트리거	메시지, 스케줄, 이벤트 트리거

다음 단계

• 설치 가이드에서 설치 방식을 자세히 고릅니다.
• 기본 개념에서 Gateway 구조를 이해합니다.
• 채널 개요에서 메시징 플랫폼 연결을 준비합니다.
• 다른 에이전트와 비교: Claude Code 소개 · Hermes 비교 가이드