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

# 시작하기

# 시작하기

목표: 최소한의 설정으로 처음부터 첫 번째로 작동하는 채팅까지 도달하는 것입니다.

<Info>
  가장 빠른 채팅: Control UI 를 엽니다(채널 설정 불필요). `openclaw dashboard` 을 실행하고
  브라우저에서 채팅하거나,
  <Tooltip headline="Gateway host" tip="The machine running the OpenClaw gateway service.">gateway host</Tooltip>에서 `http://127.0.0.1:18789/` 을 여십시오.
  문서: [Dashboard](/web/dashboard) 및 [Control UI](/web/control-ui).
</Info>

## 29. 사전 요구사항

* Node 22 이상

<Tip>
  확실하지 않은 경우 `node --version` 로 Node 버전을 확인하십시오.
</Tip>

## 빠른 설정 (CLI)

<Steps>
  <Step title="Install OpenClaw (recommended)">
    <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/veiseuleai/24AKr3LwoEceqr8Z/assets/install-script.svg?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=d1c8efb00167ca918bd206e558373c8e" alt="Install Script Process" 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>
    다른 설치 방법과 요구 사항: [Install](/install).

    </Note>
    ```
    ````
  </Step>

  <Step title="Run the onboarding wizard">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --install-daemon
    ```

    ````
    ```
    이 마법사는 인증, Gateway(게이트웨이) 설정, 선택적 채널을 구성합니다.
    자세한 내용은 [Onboarding Wizard](/start/wizard) 를 참고하십시오.
    ```
    ````
  </Step>

  <Step title="Check the Gateway">
    서비스를 설치했다면 이미 실행 중이어야 합니다:

    `````
    ````
    ```bash
    openclaw gateway status
    ```
    ````
    `````
  </Step>

  <Step title="Open the Control UI">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw dashboard
    ```
  </Step>
</Steps>

<Check>
  Control UI 가 로드되면 Gateway 는 사용 준비가 완료된 것입니다.
</Check>

## 선택적 확인 및 추가 항목

<AccordionGroup>
  <Accordion title="Run the Gateway in the foreground">
    빠른 테스트나 문제 해결에 유용합니다.

    `````
    ````
    ```bash
    openclaw gateway --port 18789
    ```
    ````
    `````
  </Accordion>

  <Accordion title="Send a test message">
    구성된 채널이 필요합니다.

    `````
    ````
    ```bash
    openclaw message send --target +15555550123 --message "Hello from OpenClaw"
    ```
    ````
    `````
  </Accordion>
</AccordionGroup>

## 유용한 환경 변수

OpenClaw를 서비스 계정으로 실행하거나 사용자 정의 구성/상태 위치를 원하는 경우:

* `OPENCLAW_HOME`은 내부 경로 해석에 사용되는 홈 디렉터리를 설정합니다.
* `OPENCLAW_STATE_DIR`는 상태 디렉터리를 재정의합니다.
* `OPENCLAW_CONFIG_PATH`는 구성 파일 경로를 재정의합니다.

전체 환경 변수 참조: [Environment vars](/help/environment).

## 더 깊이 알아보기

<Columns>
  <Card title="Onboarding Wizard (details)" href="/start/wizard">
    전체 CLI 마법사 참조 및 고급 옵션.
  </Card>

  <Card title="macOS app onboarding" href="/start/onboarding">
    macOS 앱의 첫 실행 흐름.
  </Card>
</Columns>

## 당신이 갖게 될 것

* 실행 중인 Gateway
* 구성된 인증
* Control UI 접근 또는 연결된 채널

## 다음 단계

* 다이렉트 메시지 안전 및 승인: [Pairing](/channels/pairing)
* 더 많은 채널 연결: [Channels](/channels)
* 고급 워크플로 및 소스에서 실행: [Setup](/start/setup)