Skip to main content

​
openclaw setup

openclaw setup은 시스템 에이전트 진입점입니다. 구성된 시스템에서 별도의 옵션 없이 openclaw setup을 실행하면 대화형 OpenClaw 채팅이 열립니다. 새 시스템에서는 안내형 온보딩으로 전환됩니다. 단일 요청에는 -m/--message을 사용하고, 마법사 없이 구성/워크스페이스 폴더를 초기화하려면 --baseline을 사용하십시오. 라우팅 순서:
  1. 온보딩 옵션(--wizard, --baseline, 워크스페이스, 재설정, 비대화형, 흐름, 모드, Gateway, 데몬, 건너뛰기, 가져오기, 원격 또는 인증 옵션)을 지정하면 openclaw onboard과 정확히 동일하게 온보딩을 실행합니다.
  2. -m/--message 또는 --yes은 시스템 에이전트를 실행합니다.
  3. 라우팅 옵션이 없으면 구성된 대화형 시스템에서 OpenClaw가 열립니다. 새 시스템에서는 온보딩을 실행합니다. 구성된 시스템에서는 TTY가 없어도 --json이 시스템 개요를 출력하며, 온보딩 옵션을 지정하면 온보딩의 JSON 요약이 유지됩니다.
안내형 모드에서 --workspace <dir>은 OpenClaw에 제안되는 워크스페이스이며, 해당 제안을 승인한 후에만 저장됩니다. 기준, 클래식 및 비대화형 설정은 일반적인 흐름을 통해 제공된 워크스페이스를 저장합니다. 안내형 추론 감지는 macOS 또는 Linux의 Gateway 호스트에서 실행됩니다. CLI와 macOS 앱은 구성된 모델, 지원되는 CLI 로그인, API 키 환경 변수 및 이미 설치된 Ollama 또는 LM Studio 모델을 확인하는 동일한 Gateway 소유 감지기를 호출합니다. 이 자동 처리 과정에서는 로컬 모델을 절대 다운로드하지 않습니다. 선택된 후보가 실제 완성 요청에 응답해야만 공급자 및 모델 구성이 저장됩니다. 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은 동일한 추론 게이트 OpenClaw 어시스턴트를 위한 호환성 진입점으로 유지됩니다.
openclaw setup은 변경 가능한 구성 설치용입니다. Nix 모드(OPENCLAW_NIX_MODE=1)에서는 구성 파일을 Nix가 관리하므로 OpenClaw가 설정 쓰기를 거부합니다. 공식 nix-openclaw 빠른 시작 또는 다른 Nix 패키지에 상응하는 소스 구성을 사용하십시오.

​
옵션

--classic과 --non-interactive은 상호 배타적입니다. 클래식은 프롬프트가 표시되는 마법사를 열고, 비대화형 설정은 자동화 경로를 사용합니다.

​
기준 모드

openclaw setup --baseline은 이전의 기준 전용 동작을 유지합니다. 구성, 워크스페이스 및 세션 디렉터리를 생성한 후 온보딩을 실행하지 않고 종료합니다.

​
예제

​
참고

  • 기준 설정 후 전체 안내 과정을 진행하려면 openclaw onboard을, 특정 항목을 변경하려면 openclaw configure을, 채널 계정을 추가하려면 openclaw channels add을 실행하십시오.
  • Hermes 상태가 감지되면 대화형 온보딩에서 마이그레이션을 자동으로 제안할 수 있습니다. 가져오기 온보딩에는 새로운 설정이 필요합니다. 온보딩 외부에서 시험 실행 계획, 백업 및 덮어쓰기 모드를 사용하려면 마이그레이션을 사용하십시오.

​
관련 문서