⚡ OpenClaw 빠른 설치 가이드

Windows 11 네이티브 환경 - WSL 미사용 | 텔레그램 연동까지 완벽 가이드

1. 필수 프로그램 설치 (Node.js & Git)
winget install -e --id OpenJS.NodeJS.LTS --accept-source-agreements; winget install -e --id Git.Git --accept-source-agreements
💡 PowerShell(관리자) 실행. 설치 후 창을 재시작하세요.
2. pnpm 설치
npm install -g pnpm; pnpm setup
💡 실행 후 창을 반드시 재시작하세요 (환경변수 적용).
3. OpenClaw 설치
pnpm install -g openclaw@latest
4. 초기 설정 (관리자 권한)
openclaw onboard

💡 PowerShell(관리자)에서 실행 후, 아래 순서대로 선택/입력하세요:

  • 1) I understand this is powerful and inherently risky. Continue?: Yes 선택 (Gateway 자동 설치, 가장 중요!)
  • 2) Onboarding mode: QuickStart (Enter)
  • 3) Model provider: OpenAI (Enter)
  • 4) Auth method: ChatGPT OAuth (Enter) → 브라우저 로그인
  • 5) Default model: Keep current (Enter)
  • 6) Channel: Telegram (Enter)
  • 7) Telegram Token: 봇 토큰 입력 (직접 입력 필요)
  • 8) Configure Skills: No 입력
  • 9) Enable Hooks: Skip for now (Space로 선택 후 Enter)
5. 작동 확인
✅ Gateway 서버가 백그라운드에서 실행 중입니다.
6. 텔레그램 연동
openclaw pairing approve telegram 코드
생성한 봇을 검색해서 /start 또는 아무 말이나 걸면 인증 코드를 줍니다.
받은 인증 코드를 위 명령어의 '코드' 자리에 입력해 실행하세요.
7. OpenClaw 실행 방법 (선택 2가지)

컴퓨터를 재부팅했거나 OpenClaw 서버를 종료한 경우, 아래 방법 중 하나를 선택하여 다시 실행하세요.

옵션 A: 수동 실행 (기본)

  1. PowerShell을 실행하세요. (관리자 권한 필요 없음, 일반 실행 가능)
  2. 아래 명령어를 입력하여 서버를 웁니다:
    openclaw gateway
    ⚠️ 이 창을 닫으면 서버가 꺼집니다. 켜둔 상태로 유지하세요.
  3. 새로운 PowerShell 창(Ctrl+Shift+N)을 하나 더 엽니다.
  4. 아래 명령어를 입력하여 대시보드에 접속합니다:
    openclaw dashboard

옵션 B: 자동 실행 (원클릭 스크립트 추천)

배치 파일 만들기
@echo off :: OpenClaw One-Click Startup Script echo [OpenClaw] Configuring environment... :: Ensure pnpm and OpenClaw are found in the PATH set "PATH=%LOCALAPPDATA%\pnpm;%PATH%" echo [OpenClaw] Starting Gateway Server... :: Start the gateway in a new minimized window so it keeps running start /min "OpenClaw Gateway" cmd /c "openclaw gateway" echo [OpenClaw] Waiting for server to initialize... timeout /t 5 /nobreak >nul echo [OpenClaw] Opening Dashboard... :: Open the web dashboard call openclaw dashboard echo [OpenClaw] Done! You can close this window, but keep the Gateway window open. pause
위 코드를 복사하여 메모장에 붙여넣고 Start_OpenClaw.bat 파일로 저장하세요.
이 파일을 실행하면 서버 실행 + 대시보드 열기가 한 번에 처리됩니다.

OpenClaw Quick Guide