메인 콘텐츠로 건너뛰기

​
시작하기

목표: 최소한의 설정으로 첫 작업 채팅까지 가는 것.
가장 빠른 채팅: 제어 UI를 열고 (채널 설정 필요 없음) openclaw dashboard를 실행하여 브라우저에서 채팅하거나, 게이트웨이 호스트에서 http://127.0.0.1:18789/를 엽니다. 문서: Dashboard 및 Control UI.

​
필요조건

  • Node 22 이상
Node 버전이 확실하지 않다면 node --version을 사용하여 확인하세요.

​
빠른 설정 (CLI)

1

OpenClaw 설치 (권장)

curl -fsSL https://openclaw.ai/install.sh | bash
설치 스크립트 프로세스
다른 설치 방법 및 요구 사항: 설치.
2

온보딩 마법사 실행

openclaw onboard --install-daemon
마법사는 인증, 게이트웨이 설정 및 선택적 채널을 구성합니다. 자세한 내용은 온보딩 마법사를 참조하세요.
3

게이트웨이 확인

서비스를 설치한 경우 이미 실행 중이어야 합니다:
openclaw gateway status
4

제어 UI 열기

openclaw dashboard
제어 UI가 로드되면, 게이트웨이가 사용 준비가 된 것입니다.

​
선택적 확인 및 추가 기능

빠른 테스트나 문제 해결에 유용합니다.
openclaw gateway --port 18789
구성된 채널이 필요합니다.
openclaw message send --target +15555550123 --message "Hello from OpenClaw"

​
유용한 환경 변수

OpenClaw를 서비스 계정으로 실행하거나 사용자 지정 구성/상태 위치를 원할 경우:
  • OPENCLAW_HOME은 내부 경로 해결에 사용되는 홈 디렉토리를 설정합니다.
  • OPENCLAW_STATE_DIR은 상태 디렉토리를 재정의합니다.
  • OPENCLAW_CONFIG_PATH는 구성 파일 경로를 재정의합니다.
전체 환경 변수 참조: 환경 변수.

​
더 깊이 알아보기

온보딩 마법사 (상세)

전체 CLI 마법사 참조 및 고급 옵션.

macOS 앱 온보딩

macOS 앱의 첫 실행 흐름.

​
얻을 수 있는 것

  • 실행 중인 게이트웨이
  • 인증 구성
  • 제어 UI 접근 또는 연결된 채널

​
다음 단계

  • 다이렉트 메시지 안전성 및 승인: 페어링
  • 더 많은 채널 연결: 채널
  • 고급 워크플로 및 소스에서: 설정