Setup
기준일: 2026-07-26
공식 기준: Setup
Setup 문서는 OpenClaw 공식 문서(cli/setup)를 한국어로 정리한 가이드입니다. CLI reference for openclaw setup (system-agent chat with onboarding fallback) 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.
핵심 요약
CLI reference for openclaw setup (system-agent chat with onboarding fallback)
한국어 가이드 범위: cli/setup 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.
문서 구성
공식 문서의 주요 섹션은 다음과 같습니다.
- 옵션
- Baseline mode
- 예제
- 참고
- 관련 문서
상세 내용
openclaw setup
openclaw setup is the system-agent entry point. On a configured system, bare openclaw setup opens an interactive OpenClaw chat. On a fresh system, it falls through to guided onboarding. Use -m/--message for one request or --baseline to initialize config/workspace folders without the wizard.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
옵션
--classic and --non-interactive are mutually exclusive: classic opens the prompted wizard, while noninteractive setup uses the automation path. In interactive onboarding, --remote-url and --remote-token prefill the remote Gateway step and take precedence over stored remote values for that run. Changing the URL does not reuse stored credentials unless you also pass a token. The token remains masked and uses the wizard's selected plaintext or SecretRef storage mode.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
| Flag | Description |
|---|---|
-m, --message <text> |
Run one OpenClaw request. |
--yes |
Approve persistent config writes for one --message request. |
--workspace <dir> |
Workspace proposal; existing fleets require classic confirmation and are preserved noninteractively. |
--baseline |
Create baseline config/workspace/session folders without onboarding. |
--wizard |
Force interactive onboarding. |
--tui |
Use the terminal hatch instead of the browser handoff. |
--non-interactive |
Run onboarding without prompts. |
--accept-risk |
Acknowledge full-system agent access risk; required with --non-interactive. |
--mode <mode> |
Onboarding mode: local or remote. |
--flow <flow> |
Onboard flow: quickstart, advanced, manual, or import. |
--reset |
Reset config + credentials + sessions before onboarding (workspace only with --reset-scope full). |
--reset-scope <scope> |
Reset scope: config, config+creds+sessions, or full. |
--import-from <provider> |
Migration provider to run during onboarding. |
--import-source <path> |
Source agent home for --import-from. |
--import-secrets |
Import supported secrets during onboarding migration. |
--remote-url <url> |
Remote Gateway WebSocket URL. |
--remote-token <token> |
Remote Gateway token (optional). |
--json |
Configured system: OpenClaw overview. Onboarding route: onboarding summary. |
Baseline mode
openclaw setup --baseline preserves the older baseline-only behavior: it creates the config, workspace, and session directories, then exits without running onboarding. It accepts --workspace and harmless output controls, but rejects explicit onboarding, Gateway, auth, reset, or daemon options instead of silently ignoring them. If an existing config is invalid, baseline setup preserves it and asks you to run openclaw doctor before retrying.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
예제
openclaw setup
openclaw setup -m "status"
openclaw setup -m "restart gateway" --yes
openclaw setup --json
openclaw setup --wizard
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>
참고
주요 항목:
- After baseline setup, run
openclaw onboardfor the full guided journey,openclaw configurefor targeted changes, oropenclaw channels addto add channel accounts. - If Hermes state is detected, interactive onboarding can offer migration automatically. Import onboarding requires a fresh setup; use Migrate for dry-run plans, backups, and overwrite mode outside onboarding.
관련 문서
주요 항목:
- CLI reference
- Onboard
- Onboarding (CLI)
- Getting started
- Install overview
실습 체크리스트
- 공식 문서와 로컬 버전을 대조합니다:
https://docs.openclaw.ai/cli/setup - 관련 CLI는
openclaw --help및 하위 명령--help로 옵션을 확인합니다. - 설정 변경 시
openclaw config/openclaw doctor로 유효성을 검사합니다. - Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.
자주 쓰는 명령·설정 예시
openclaw setup
openclaw setup -m "status"
openclaw setup -m "restart gateway" --yes
openclaw setup --json
openclaw setup --wizard
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>
관련 링크
- 공식 원문: cli/setup
- OpenClaw 문서 홈
이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.