온보딩 위저드 레퍼런스

openclaw onboard CLI 위저드의 전체 레퍼런스입니다. 상위 수준 개요는 온보딩 위저드를 참조하세요.

흐름 세부사항 (로컬 모드)

1단계: 기존 설정 감지

~/.openclaw/openclaw.json이 존재하면 유지 / 수정 / 초기화 선택.
위저드를 다시 실행해도 명시적으로 초기화를 선택하지 않으면 아무것도 삭제하지 않음.

2단계: 모델/인증

Anthropic API 키, Anthropic OAuth, Anthropic 토큰, OpenAI Code, OpenAI API 키, xAI (Grok), OpenCode, Ollama, Vercel AI Gateway, Cloudflare AI Gateway, MiniMax, Synthetic, Moonshot 등 다양한 프로바이더 지원.

3단계: 워크스페이스

기본 ~/.openclaw/workspace (설정 가능).
에이전트 부트스트랩 의식에 필요한 워크스페이스 파일 시드.

4단계: Gateway

포트, 바인드, 인증 모드, tailscale 노출.

5단계: 채널

WhatsApp, Telegram, Discord, Google Chat, Mattermost, Signal, BlueBubbles, iMessage 등.

6단계: 웹 검색

Perplexity, Brave, Gemini, Grok, Kimi 중 선택 (또는 건너뛰기).

7단계: 데몬 설치

macOS: LaunchAgent
Linux (및 WSL2 경유 Windows): systemd 사용자 유닛

8단계: 상태 점검

Gateway를 시작하고 openclaw health 실행.

9단계: 스킬 (권장)

사용 가능한 스킬을 읽고 요구사항 확인.

10단계: 완료

요약 + 다음 단계.

비대화형 모드

--non-interactive로 온보딩을 자동화하거나 스크립팅할 수 있습니다:

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback \
  --install-daemon \
  --daemon-runtime node \
  --skip-skills

Gateway 위저드 RPC

Gateway가 RPC(wizard.start, wizard.next, wizard.cancel, wizard.status)를 통해 위저드 흐름을 노출합니다. 클라이언트(macOS 앱, Control UI)가 온보딩 로직을 재구현하지 않고 단계를 렌더링할 수 있습니다.