> ## 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 setup`

전체 CLI 온보딩 흐름을 실행합니다. `openclaw setup`은 `openclaw onboard`의 별칭입니다. 마법사 없이 설정/작업공간 폴더만 초기화하면 되는 경우 `--baseline`을 사용하세요.

<Note>
  `openclaw setup`은 변경 가능한 설정 설치용입니다. Nix 모드(`OPENCLAW_NIX_MODE=1`)에서는 설정 파일이 Nix에서 관리되므로 OpenClaw가 설정 쓰기를 거부합니다. 일급 [nix-openclaw 빠른 시작](https://github.com/openclaw/nix-openclaw#quick-start) 또는 다른 Nix 패키지에 해당하는 동등한 소스 설정을 사용하세요.
</Note>

## 옵션

| 플래그                        | 설명                                                                             |
| -------------------------- | ------------------------------------------------------------------------------ |
| `--workspace <dir>`        | 에이전트 작업공간 디렉터리(기본값 `~/.openclaw/workspace`; `agents.defaults.workspace`로 저장됨). |
| `--baseline`               | 온보딩 없이 기본 설정/작업공간/세션 폴더를 만듭니다.                                                 |
| `--wizard`                 | 호환성을 위해 허용됩니다. 설정은 기본적으로 온보딩을 실행합니다.                                           |
| `--non-interactive`        | 프롬프트 없이 온보딩을 실행합니다.                                                            |
| `--accept-risk`            | 전체 시스템 에이전트 접근 위험을 인정합니다. `--non-interactive`와 함께 필요합니다.                       |
| `--mode <mode>`            | 온보딩 모드: `local` 또는 `remote`.                                                   |
| `--import-from <provider>` | 온보딩 중 실행할 마이그레이션 제공자입니다.                                                       |
| `--import-source <path>`   | `--import-from`의 소스 에이전트 홈입니다.                                                 |
| `--import-secrets`         | 온보딩 마이그레이션 중 지원되는 비밀을 가져옵니다.                                                   |
| `--remote-url <url>`       | 원격 Gateway WebSocket URL입니다.                                                   |
| `--remote-token <token>`   | 원격 Gateway 토큰(선택 사항)입니다.                                                       |

### 기본 모드

`openclaw setup --baseline`은 이전의 기본값 전용 동작을 보존합니다. 설정, 작업공간, 세션 디렉터리를 만든 다음 온보딩을 실행하지 않고 종료합니다.

## 예시

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw setup
openclaw setup --baseline
openclaw setup --workspace ~/.openclaw/workspace
openclaw setup --import-from hermes --import-source ~/.hermes
openclaw setup --non-interactive --accept-risk --mode remote --remote-url wss://gateway-host:18789 --remote-token <token>
```

## 참고

* 일반 `openclaw setup`은 `openclaw onboard`와 동일한 안내 여정을 실행합니다.
* 기본 설정 후에는 전체 안내 여정을 위해 `openclaw setup` 또는 `openclaw onboard`를 실행하고, 대상 변경에는 `openclaw configure`를, 채널 계정을 추가하려면 `openclaw channels add`를 실행하세요.
* Hermes 상태가 감지되면 대화형 온보딩에서 자동으로 마이그레이션을 제안할 수 있습니다. 가져오기 온보딩에는 새 설정이 필요합니다. 온보딩 밖에서 드라이런 계획, 백업, 덮어쓰기 모드를 사용하려면 [마이그레이션](/ko/cli/migrate)을 사용하세요.

## 관련

* [CLI 참조](/ko/cli)
* [온보딩(CLI)](/ko/start/wizard)
* [시작하기](/ko/start/getting-started)
* [설치 개요](/ko/install)