메인 콘텐츠로 건너뛰기

​
시작하기

목표: 최소한의 설정으로 아무것도 없는 상태에서 첫 번째 작동하는 채팅까지 가는 것입니다.
가장 빠른 시작 방법은 Control UI를 여는 것입니다(채널 설정 불필요). openclaw dashboard를 실행해 브라우저에서 채팅하거나, 에서 http://127.0.0.1:18789/를 여세요. 관련 문서: 대시보드, Control UI.

​
사전 요구사항

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

​
빠른 설정 (CLI)

1

OpenClaw 설치 (권장)

curl -fsSL https://openclaw.ai/install.sh | bash
Install Script Process
다른 설치 방법과 요구사항은 Install을 참고하세요.
2

온보딩 마법사 실행

openclaw onboard --install-daemon
마법사가 인증, Gateway 설정, 선택적 채널 구성을 안내합니다. 자세한 내용은 온보딩 마법사를 참고하세요.
3

Gateway 상태 확인

서비스를 설치했다면 이미 실행 중이어야 합니다.
openclaw gateway status
4

Control UI 열기

openclaw dashboard
Control UI가 정상적으로 로드되면 Gateway를 사용할 준비가 된 것입니다.

​
선택적 확인 및 추가 사항

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

​
유용한 환경 변수

서비스 계정으로 OpenClaw를 실행하거나 config/state 위치를 직접 지정하려면 다음 환경 변수를 사용할 수 있습니다.
  • OPENCLAW_HOME은 내부 경로 해석에 사용할 홈 디렉터리를 설정합니다.
  • OPENCLAW_STATE_DIR은 상태 디렉터리를 재정의합니다.
  • OPENCLAW_CONFIG_PATH는 설정 파일 경로를 재정의합니다.
전체 환경 변수 목록: Environment vars.

​
더 알아보기

온보딩 마법사 (상세)

전체 CLI 마법사 레퍼런스와 고급 옵션입니다.

macOS 앱 온보딩

macOS 앱의 첫 실행 흐름입니다.

​
완료 후 갖추게 되는 것

  • 실행 중인 Gateway
  • 구성된 인증
  • Control UI 액세스 또는 연결된 채널

​
다음 단계

  • DM 안전성과 승인: 페어링
  • 채널 더 연결하기: 채널
  • 고급 워크플로우와 소스 기준 설정: 설정