OpenClaw를 바로 작동하게 하는 방법

Source: Dev.to

Versions

설치

1. Node.js가 아직 설치되지 않았다면 설치합니다.

2. 특정 OpenClaw 릴리스를 설치합니다:

   npm install -g openclaw@2026.4.22
   # added 498 packages in 51s

3. 설치를 확인합니다:

   openclaw -v
   # OpenClaw 2026.4.22 (00bd2cf)

Note: 이 가이드는 재현성을 위해 버전 2026.4.22에 고정되어 있습니다. 최신 릴리스는 깨지는 변경 사항을 포함할 수 있습니다.

초기 설정

OpenClaw은 모델 제공자와 API 키가 필요합니다. 이 가이드는 Google AI Studio를 사용합니다.

1. Google AI Studio에서 Gemini API 키를 생성하고 안전하게 보관합니다.

2. 온보딩 명령을 실행합니다:

   openclaw onboard

   명령 실행 시 추가 구성 요소가 설치되는 동안 몇 분 정도 걸릴 수 있습니다. 프롬프트가 나타나면 아래와 같이 질문에 답하여 빠른 시작 설정을 완료합니다.

   질문	답변
   개인‑기본이며 공유/다중‑사용자는 잠금이 필요함을 이해합니다. 계속하시겠습니까?	yes
   설정 모드	QuickStart
   모델/인증 제공자	Google
   Gemini API 키 입력	Paste the key you generated
   모델	google/gemini-2.5-flash
   채널 선택 (QuickStart)	Skip for Now
   검색 제공자	Skip for Now
   지금 스킬을 구성하시겠습니까? (권장)	No
   훅을 활성화하시겠습니까?	Skip for now
   봇을 어떻게 부화시키시겠습니까?	Do this later

3. 기본 모델을 확인합니다:

   openclaw models
   # (output should list google/gemini-2.5-flash as the default)

에이전트와 첫 채팅

두 개의 터미널을 엽니다:

• 터미널 1 – 게이트웨이(서버) 시작:

  openclaw gateway

• 터미널 2 – 텍스트 UI(클라이언트) 열기:

  openclaw tui

UI가 준비되면 Hello와 같은 인사말을 입력합니다. 에이전트가 응답하면 설정이 정상적으로 작동한 것입니다.

축하합니다, 성공했습니다

이제 OpenClaw 에이전트와 상호작용하고, 행동, 성격, 작업을 정의하며, 그 기능을 계속 탐색할 수 있습니다.

추가: 고려 사항

• 예산 안전: 예상치 못한 비용 발생을 방지하기 위해 Google Gemini API 키에 낮은 사용 한도(예: $1)를 설정합니다.

• 프로세스 정리: Windows에서는 OpenClaw 프로세스를 종료하려면 다음이 필요할 수 있습니다:

  taskkill /F /IM node.exe /T

• 버전 업데이트: 최신 릴리스를 시도하고 싶다면 npm install 명령에서 2026.4.22를 원하는 버전으로 교체하면 되지만, 잠재적인 깨지는 변경 사항에 대비하십시오.