OpenClaw 시작하기: 5분 만에 첫 번째 채팅 설정하기

새로운 도구를 도입할 때 가장 지치는 순간은 아마 끝이 보이지 않는 복잡한 설정 과정일 거예요. 특히 통신 게이트웨이나 API 연결은 환경 설정만 하다가 하루가 다 가는 경우도 많죠. OpenClaw는 이런 번거로운 과정을 줄이고 개발자가 바로 기능을 테스트할 수 있도록 설계되었어요.

필요한 것

시작하기 전에 아래 조건이 충족되었는지 확인해 주세요.

• Node 22 또는 최신 버전 (터미널에서 node --version으로 확인할 수 있어요)

빠른 시작

가장 빠르게 채팅을 시작하는 방법은 Control UI를 사용하는 거예요. 채널 설정 없이도 브라우저에서 바로 확인할 수 있습니다.

1. OpenClaw 설치하기

사용 중인 OS에 맞춰 아래 명령어를 실행해 주세요.

macOS/Linux:

curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell):

iwr -useb https://openclaw.ai/install.ps1 | iex

2. 온보딩 위저드 실행

설치 후 아래 명령어를 입력하면 인증, Gateway 설정, 채널 옵션을 구성할 수 있어요.

openclaw onboard --install-daemon

3. Gateway 상태 확인

서비스를 설치했다면 이미 실행 중일 거예요. 아래 명령어로 상태를 체크해 보세요.

openclaw gateway status

4. Control UI 열기

이제 대시보드에 접속할 차례예요.

openclaw dashboard

브라우저에서 Control UI가 로드된다면 Gateway가 정상적으로 준비된 거예요.

문제 해결

설정 과정에서 문제가 생겼다면 아래 방법을 시도해 보세요.

• Gateway를 직접 실행하고 싶은 경우: 문제 해결이나 빠른 테스트를 위해 포트를 지정해 포그라운드에서 실행할 수 있어요.

  openclaw gateway --port 18789

• 테스트 메시지 전송: 채널 설정이 완료되었다면 실제 메시지가 가는지 확인해 보세요.

  openclaw message send --target +15555550123 --message "Hello from OpenClaw"

유용한 환경 변수

커스텀 경로 설정이 필요한 경우 아래 환경 변수를 활용하세요.

• OPENCLAW_HOME: 내부 경로 확인에 사용되는 홈 디렉토리를 설정해요.
• OPENCLAW_STATE_DIR: 상태 디렉토리 경로를 변경해요.
• OPENCLAW_CONFIG_PATH: 설정 파일 경로를 직접 지정해요.

더 자세한 내용은 AI Setup Assistant에게 물어보세요.

다음 단계

성공적으로 설정을 마쳤다면 다음 단계로 넘어가 보세요.

• Pairing: DM 보안 및 승인 설정하기
• Channels: 더 많은 채널 연결하기
• Setup: 고급 워크플로우 및 소스 설치 안내