> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 시작하기

OpenClaw를 설치하고, 온보딩을 실행한 뒤, AI 어시스턴트와 채팅하세요. 모두
약 5분이면 됩니다. 완료하면 실행 중인 Gateway, 구성된 인증,
작동하는 채팅 세션을 갖게 됩니다.

## 필요한 것

* **Node.js** — Node 24 권장(Node 22.19+도 지원)
* 모델 제공업체(Anthropic, OpenAI, Google 등)의 **API 키** — 온보딩 중 입력하라는 메시지가 표시됩니다

<Tip>
  `node --version`으로 Node 버전을 확인하세요.
  **Windows 사용자:** 네이티브 Windows Hub 앱이 가장 쉬운 데스크톱 경로입니다.
  PowerShell 설치 프로그램과 WSL2 Gateway 경로도 지원됩니다. [Windows](/ko/platforms/windows)를 참조하세요.
  Node를 설치해야 하나요? [Node 설정](/ko/install/node)을 참조하세요.
</Tip>

## 빠른 설정

<Steps>
  <Step title="OpenClaw 설치">
    <Tabs>
      <Tab title="macOS / Linux">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        curl -fsSL https://openclaw.ai/install.sh | bash
        ```

        <img src="https://mintcdn.com/clawdhub/U8jr7qEbUc9OU9YR/assets/install-script.svg?fit=max&auto=format&n=U8jr7qEbUc9OU9YR&q=85&s=50706f81e3210a610262f14facb11f65" alt="설치 스크립트 프로세스" className="rounded-lg" width="1370" height="581" data-path="assets/install-script.svg" />
      </Tab>

      <Tab title="Windows (PowerShell)">
        ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
        iwr -useb https://openclaw.ai/install.ps1 | iex
        ```
      </Tab>
    </Tabs>

    <Note>
      기타 설치 방법(Docker, Nix, npm): [설치](/ko/install).
    </Note>
  </Step>

  <Step title="온보딩 실행">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --install-daemon
    ```

    마법사가 모델 제공업체 선택, API 키 설정,
    Gateway 구성을 안내합니다. QuickStart는 보통 몇 분이면 끝나지만,
    제공업체 로그인, 채널 페어링, 데몬 설치, 네트워크 다운로드, Skills,
    또는 선택적 Plugin 때문에 전체 온보딩 시간이 더 길어질 수 있습니다. 선택 단계는 건너뛰고
    나중에 `openclaw configure`로 돌아올 수 있습니다.

    전체 참조는 [온보딩(CLI)](/ko/start/wizard)을 참조하세요.
  </Step>

  <Step title="Gateway 실행 확인">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw gateway status
    ```

    Gateway가 포트 18789에서 수신 중인 것을 볼 수 있습니다.
  </Step>

  <Step title="대시보드 열기">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw dashboard
    ```

    브라우저에서 Control UI가 열립니다. 로드되면 모든 것이 작동 중입니다.
  </Step>

  <Step title="첫 메시지 보내기">
    Control UI 채팅에 메시지를 입력하면 AI 응답을 받을 수 있습니다.

    대신 휴대폰에서 채팅하고 싶나요? 가장 빠르게 설정할 수 있는 채널은
    [Telegram](/ko/channels/telegram)(봇 토큰만 필요)입니다. 모든 옵션은 [채널](/ko/channels)을 참조하세요.
  </Step>
</Steps>

<Accordion title="고급: 사용자 지정 Control UI 빌드 마운트">
  현지화되었거나 사용자 지정된 대시보드 빌드를 유지 관리한다면,
  빌드된 정적 에셋과 `index.html`이 들어 있는 디렉터리를
  `gateway.controlUi.root`로 지정하세요.

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  mkdir -p "$HOME/.openclaw/control-ui-custom"
  # 빌드된 정적 파일을 해당 디렉터리에 복사합니다.
  ```

  그런 다음 다음을 설정하세요.

  ```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
  {
    "gateway": {
      "controlUi": {
        "enabled": true,
        "root": "$HOME/.openclaw/control-ui-custom"
      }
    }
  }
  ```

  Gateway를 다시 시작하고 대시보드를 다시 여세요.

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  openclaw gateway restart
  openclaw dashboard
  ```
</Accordion>

## 다음에 할 일

<Columns>
  <Card title="채널 연결" href="/ko/channels" icon="message-square">
    Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo 등.
  </Card>

  <Card title="페어링 및 안전" href="/ko/channels/pairing" icon="shield">
    에이전트에게 메시지를 보낼 수 있는 사람을 제어하세요.
  </Card>

  <Card title="Gateway 구성" href="/ko/gateway/configuration" icon="settings">
    모델, 도구, 샌드박스, 고급 설정.
  </Card>

  <Card title="도구 둘러보기" href="/ko/tools" icon="wrench">
    브라우저, exec, 웹 검색, Skills, Plugin.
  </Card>
</Columns>

<Accordion title="고급: 환경 변수">
  OpenClaw를 서비스 계정으로 실행하거나 사용자 지정 경로를 원한다면:

  * `OPENCLAW_HOME` — 내부 경로 확인을 위한 홈 디렉터리
  * `OPENCLAW_STATE_DIR` — 상태 디렉터리 재정의
  * `OPENCLAW_CONFIG_PATH` — 구성 파일 경로 재정의

  전체 참조: [환경 변수](/ko/help/environment).
</Accordion>

## 관련

* [설치 개요](/ko/install)
* [채널 개요](/ko/channels)
* [설정](/ko/start/setup)