openclaw onboard
대화형 온보딩 마법사 (로컬 또는 원격 게이트웨이 설정).
관련 안내서
Examples
openclaw onboard
openclaw onboard --flow quickstart
openclaw onboard --flow manual
openclaw onboard --mode remote --remote-url ws://gateway-host:18789
openclaw onboard --non-interactive \
--auth-choice custom-api-key \
--custom-base-url "https://llm.example.com/v1" \
--custom-model-id "foo-large" \
--custom-api-key "$CUSTOM_API_KEY" \
--custom-compatibility openai
--custom-api-key는 비대화형 모드에서 선택 사항입니다. 생략하면 온보딩이 CUSTOM_API_KEY를 확인합니다.
비대화형 Ollama:
openclaw onboard --non-interactive \
--auth-choice ollama \
--custom-base-url "http://ollama-host:11434" \
--custom-model-id "qwen3.5:27b" \
--accept-risk
--custom-base-url의 기본값은 http://127.0.0.1:11434입니다. --custom-model-id는 선택 사항이며, 생략하면 온보딩이 Ollama의 권장 기본값을 사용합니다. kimi-k2.5:cloud 같은 클라우드 모델 ID도 여기서 동작합니다.
비대화형 Z.AI 엔드포인트 선택:
참고: --auth-choice zai-api-key는 이제 키에 대한 최적의 Z.AI 엔드포인트를 자동으로 감지합니다 (일반 API를 zai/glm-5로 우선 선택).
특히 GLM 코딩 플랜 엔드포인트를 원하시면 zai-coding-global 또는 zai-coding-cn을 선택하십시오.
# 프롬프트 없는 엔드포인트 선택
openclaw onboard --non-interactive \
--auth-choice zai-coding-global \
--zai-api-key "$ZAI_API_KEY"
# 다른 Z.AI 엔드포인트 선택:
# --auth-choice zai-coding-cn
# --auth-choice zai-global
# --auth-choice zai-cn
--skip-health를 넘기지 않으면, 온보딩은 성공적으로 종료되기 전에 도달 가능한 로컬 gateway를 기다립니다.--install-daemon은 먼저 관리형 gateway 설치 경로를 시작합니다. 이 플래그가 없으면 예를 들어 openclaw gateway run처럼 이미 로컬 gateway가 실행 중이어야 합니다.- 자동화에서 config/workspace/bootstrap 쓰기만 원한다면
--skip-health를 사용하세요.
- 네이티브 Windows에서는
--install-daemon이 먼저 Scheduled Tasks를 시도하고, 작업 생성이 거부되면 사용자별 Startup 폴더 로그인 항목으로 폴백합니다.
Flow notes:
quickstart: 최소 프롬프트, 게이트웨이 토큰 자동 생성.manual: 포트/바인드/인증에 대한 전체 프롬프트 (advanced의 별칭).- 가장 빠른 첫 번째 채팅:
openclaw dashboard (채널 설정 없이 제어 UI).
- 커스텀 프로바이더: 나열되지 않은 호스팅 프로바이더 포함, OpenAI 또는 Anthropic 호환 엔드포인트에 연결.
Unknown을 사용하여 자동 감지.
Common follow-up commands
openclaw configure
openclaw agents add <name>
--json은 비대화형 모드를 의미하지 않습니다. 스크립트에는 --non-interactive를 사용하십시오.
