English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

First steps

시작하기

OpenClaw를 설치하고, 온보딩을 실행하고, AI 비서와 채팅하세요 — 이 모든 과정을 약 5분 안에 마칠 수 있습니다. 끝나면 실행 중인 Gateway, 구성된 인증, 그리고 동작하는 채팅 세션을 갖게 됩니다.

준비물

  • Node.js — Node 24 권장(Node 22.14+도 지원)
  • 모델 provider의 API 키(Anthropic, OpenAI, Google 등) — 온보딩이 이를 물어봅니다

빠른 설정

  • OpenClaw 설치

    macOS / Linux

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

    Install Script Process

    Windows (PowerShell)

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

  • 온보딩 실행

    openclaw onboard --install-daemon

    마법사는 모델 provider 선택, API 키 설정, Gateway 구성을 안내합니다. 약 2분 정도 걸립니다.

    전체 참조는 Onboarding (CLI)를 참조하세요.

  • Gateway가 실행 중인지 확인

    openclaw gateway status

    Gateway가 18789 포트에서 listening 중이라는 표시가 보여야 합니다.

  • 대시보드 열기

    openclaw dashboard

    브라우저에서 Control UI가 열립니다. 로드된다면 모든 것이 정상 동작 중입니다.

  • 첫 메시지 보내기

    Control UI 채팅에서 메시지를 입력하면 AI 응답을 받을 수 있어야 합니다.

    휴대폰에서 채팅하고 싶나요? 가장 빠르게 설정할 수 있는 채널은 Telegram입니다(봇 토큰만 있으면 됨). 모든 옵션은 Channels를 참조하세요.

    • 고급: 사용자 지정 Control UI 빌드 마운트

    현지화되었거나 사용자 지정된 dashboard 빌드를 유지하는 경우 gateway.controlUi.root를 빌드된 정적 자산과 index.html이 들어 있는 디렉터리로 지정하세요.

    mkdir -p "$HOME/.openclaw/control-ui-custom"
# Copy your built static files into that directory.

    그다음 설정:

    {
"gateway": {
  "controlUi": {
    "enabled": true,
    "root": "$HOME/.openclaw/control-ui-custom"
  }
}
}

    gateway를 재시작하고 dashboard를 다시 엽니다.

    openclaw gateway restart
openclaw dashboard

    다음에 할 일

    채널 연결

    Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo 등.
    페어링 및 안전

    누가 에이전트에 메시지를 보낼 수 있는지 제어하세요.
    Gateway 구성

    모델, 도구, 샌드박스, 고급 설정.
    도구 둘러보기

    브라우저, exec, 웹 검색, Skills, Plugin.
    고급: 환경 변수

    서비스 계정으로 OpenClaw를 실행하거나 사용자 지정 경로를 원한다면:

    • OPENCLAW_HOME — 내부 경로 확인용 홈 디렉터리
    • OPENCLAW_STATE_DIR — 상태 디렉터리 재정의
    • OPENCLAW_CONFIG_PATH — 설정 파일 경로 재정의

    전체 참조: Environment variables.

    관련 항목