OpenClaw 시작 가이드 — 몇 분 만에 AI 어시스턴트 설정하기

OpenClaw을 시작하려면 npm install -g openclaw@latest로 전역 설치한 후 openclaw onboard를 실행하여 인스턴스를 구성합니다. 온보딩 마법사가 AI 모델 설정, WhatsApp이나 Telegram 같은 메시징 채널 연결, 워크스페이스 구성 과정을 안내합니다. 또는 MyClaw.ai에서 관리형 호스팅을 제공하여 설정 없이 즉시 인스턴스를 사용할 수 있습니다.

OpenClaw란?

OpenClaw(이전 Clawdbot)은 자신의 컴퓨터에서 실행되는 오픈소스 개인 AI 어시스턴트입니다. 클라우드 전용 AI 도구와 달리, OpenClaw은 완전한 제어권을 제공합니다. 데이터는 로컬에 유지되며, 이미 사용 중인 메시징 앱(WhatsApp, Telegram, Slack, Discord, Signal, iMessage 등)을 통해 상호작용합니다.

OpenClaw 시작하기

시작하는 방법은 두 가지입니다:

1. 셀프 호스팅 — 자신의 컴퓨터에 설치 (이 가이드)
2. 관리형 호스팅 — MyClaw.ai에서 모든 것을 관리

셀프 호스팅 사전 요구 사항

OpenClaw을 설치하기 전에 다음을 확인하세요:

• Node.js — 버전 22 이상 (여기서 다운로드)
• 운영 체제 — macOS, Linux 또는 Windows (WSL2 강력 권장)

1단계: OpenClaw 설치

가장 빠르게 시작하는 방법은 전역 설치입니다:

npm install -g openclaw@latest

2단계: 온보딩 마법사 실행

온보딩 마법사가 전체 설정 과정을 안내합니다:

openclaw onboard --install-daemon

마법사가 안내하는 내용:

• 모델 설정 — AI 모델(Claude, GPT 또는 로컬 모델)을 선택하고 API 인증을 구성
• 채널 연결 — 메시징 앱(WhatsApp, Telegram, Slack, Discord 등) 연결
• 워크스페이스 초기화 — ~/.openclaw/workspace에 로컬 워크스페이스 설정
• 스킬 구성 — ClawHub에서 스킬 탐색 및 설치
• 데몬 설치 — 백그라운드 서비스(macOS에서는 launchd, Linux에서는 systemd)를 설정하여 OpenClaw이 지속적으로 실행되도록 함

3단계: 설정 확인

내장 진단 도구를 실행하여 모든 것이 올바르게 구성되었는지 확인합니다:

openclaw doctor

4단계: 첫 번째 메시지 보내기

채널이 연결되면, 메시징 앱을 통해 OpenClaw에게 메시지를 보냅니다. 친구에게 문자를 보내는 것과 같습니다. 예를 들어, WhatsApp이나 Telegram에서 다음과 같이 보냅니다:

"무엇을 도와줄 수 있나요?"

명령줄에서 직접 상호작용할 수도 있습니다:

openclaw agent --message "무엇을 도와줄 수 있나요?"

OpenClaw은 같은 채널로 응답합니다. 여기서부터 이메일 관리, 캘린더 확인, 웹 브라우징, 코드 작성 또는 설치된 스킬 실행을 요청할 수 있습니다.

유용한 명령어

OpenClaw이 실행되면 다음 명령어로 관리할 수 있습니다:

명령어	기능
/status	현재 세션 상태 확인
/new 또는 /reset	대화 세션 초기화
/think <level>	추론 깊이 제어
openclaw doctor	구성 문제 진단
openclaw update --channel stable	최신 버전으로 업데이트

일반적인 설정 문제

포트 충돌

"포트가 이미 사용 중" 오류가 표시되면 다른 포트를 지정합니다:

openclaw gateway --port 18790

지원되지 않는 Node 버전

OpenClaw은 Node.js 22 이상이 필요합니다. 버전을 확인하세요:

node --version

이전 버전인 경우 nodejs.org에서 업데이트하거나 nvm을 사용하세요:

nvm install 22
nvm use 22

macOS 권한 오류

OpenClaw은 특정 기능에 대해 접근성 권한이 필요할 수 있습니다. 다음으로 이동하세요:

시스템 설정 > 개인정보 보호 및 보안 > 손쉬운 사용

터미널 앱을 허용 목록에 추가하세요.

더 쉬운 대안: 관리형 호스팅

셀프 호스팅은 완전한 제어권을 제공하지만, 업데이트, 가동 시간, 구성을 직접 관리해야 합니다. 이 모든 것을 건너뛰고 싶다면 MyClaw.ai가 클라우드에서 OpenClaw을 실행해 줍니다:

• 설정 불필요 — 설치, 구성, 디버깅이 필요 없음
• 항상 온라인 — 컴퓨터를 켜두지 않아도 인스턴스가 24시간 실행
• 자동 업데이트 — 항상 OpenClaw 최신 버전 실행

셀프 호스팅이든 관리형이든, 가장 중요한 것은 OpenClaw을 사용하기 시작하고 워크플로우에 어떤 도움을 줄 수 있는지 발견하는 것입니다.

다음 단계

OpenClaw이 실행되면:

• 스킬 마켓플레이스(ClawHub)에서 커뮤니티가 만든 통합 기능 탐색
• 추가 메시징 채널 연결 시도
• OpenClaw 커뮤니티 Discord에 참여하여 팁과 지원 받기
• OpenClaw란?에서 기능 심층 분석 확인
• 소스에서 빌드하려면 전체 설치 가이드 참조