CLI commands
설정
openclaw setup
openclaw setup은 openclaw onboard와 동일한 안내형 온보딩 흐름을 실행합니다.
먼저 추론 구성을 확인하고 저장한 다음, Crestodian을 시작하여
작업 공간, Gateway, 채널, Skills 및 상태를 구성합니다. 마법사 없이
구성/작업 공간 폴더만 초기화하려면 --baseline을 사용하세요.
안내형 모드에서 --workspace <dir>은 Crestodian에 제안되는 작업 공간이며,
해당 제안을 승인한 후에만 저장됩니다. 기준선, 클래식 및
비대화형 설정에서는 제공된 작업 공간을 각자의 일반적인 흐름을 통해 저장합니다.
setup은 인증(--auth-choice, --token, 공급자 키 플래그), Gateway
(--gateway-port, --gateway-bind, --gateway-auth, --install-daemon),
Tailscale(--tailscale), 초기화(--reset, --reset-scope), 흐름
(--flow quickstart|advanced|manual|import) 및 건너뛰기 플래그
(--skip-channels, --skip-skills, --skip-bootstrap, --skip-search,
--skip-health, --skip-ui, --skip-hooks)를 포함하여 openclaw onboard와
동일한 온보딩 플래그를 허용합니다. 전체 플래그 참조와 비대화형 예시는
온보딩 및 CLI 자동화를 참조하세요.
openclaw onboard --modern은 추론 구성을 필수로 확인하는 Crestodian 도우미의
호환성 별칭이며, 이에 해당하는 setup 옵션은 없습니다.
옵션
| 플래그 | 설명 |
|---|---|
--workspace <dir> |
안내형 모드의 작업 공간 제안입니다. 기준선, 클래식 및 비대화형 설정에서는 직접 저장됩니다. |
--baseline |
온보딩 없이 기준선 구성/작업 공간/세션 폴더를 생성합니다. |
--wizard |
호환성을 위해 허용됩니다. 설정은 기본적으로 온보딩을 실행합니다. |
--non-interactive |
프롬프트 없이 온보딩을 실행합니다. |
--accept-risk |
에이전트의 전체 시스템 접근 위험을 인지합니다. --non-interactive와 함께 사용해야 합니다. |
--mode <mode> |
온보딩 모드: local 또는 remote. |
--flow <flow> |
온보딩 흐름: quickstart, advanced, manual 또는 import. |
--reset |
온보딩 전에 구성 + 자격 증명 + 세션을 초기화합니다(--reset-scope full을 사용한 경우에만 작업 공간 포함). |
--reset-scope <scope> |
초기화 범위: config, config+creds+sessions 또는 full. |
--import-from <provider> |
온보딩 중 실행할 마이그레이션 공급자입니다. |
--import-source <path> |
--import-from에 사용할 원본 에이전트 홈입니다. |
--import-secrets |
온보딩 마이그레이션 중 지원되는 비밀 정보를 가져옵니다. |
--remote-url <url> |
원격 Gateway WebSocket URL입니다. |
--remote-token <token> |
원격 Gateway 토큰입니다(선택 사항). |
--json |
JSON 요약을 출력합니다. |
--classic과 --non-interactive는 함께 사용할 수 없습니다. 클래식은
프롬프트가 있는 마법사를 여는 반면, 비대화형 설정은 자동화 경로를 사용합니다.
기준선 모드
openclaw setup --baseline은 이전의 기준선 전용 동작을 유지합니다.
구성, 작업 공간 및 세션 디렉터리를 만든 다음 온보딩을 실행하지 않고
종료합니다.
예시
openclaw setupopenclaw setup --baselineopenclaw setup --workspace ~/.openclaw/workspaceopenclaw setup --import-from hermes --import-source ~/.hermesopenclaw setup --non-interactive --accept-risk --mode remote --remote-url wss://gateway-host:18789 --remote-token <token>참고
- 기준선 설정 후 전체 안내 과정을 진행하려면
openclaw setup또는openclaw onboard를 실행하고, 특정 항목만 변경하려면openclaw configure를 실행하거나, 채널 계정을 추가하려면openclaw channels add를 실행하세요. - Hermes 상태가 감지되면 대화형 온보딩에서 마이그레이션을 자동으로 제안할 수 있습니다. 가져오기 온보딩에는 새로운 설정이 필요합니다. 온보딩 외부에서 시험 실행 계획, 백업 및 덮어쓰기 모드를 사용하려면 마이그레이션을 사용하세요.
