First steps
온보딩 개요
OpenClaw에는 터미널 및 macOS 앱 온보딩이 있습니다. 두 방식 모두 추론을 먼저 설정합니다. 기존 AI 액세스를 감지하고 실제 완료를 요구한 다음에만 Crestodian을 시작하여 나머지 설정을 구성합니다. 연결 가능하고 구성이 완료된 Gateway에서 기본 에이전트에 이미 모델이 구성되어 있으면 온보딩을 건너뛰고 일반 에이전트 UI를 엽니다. 터미널 흐름에서는 세부 설정을 위한 전체 클래식 마법사도 제공합니다.
어떤 경로를 사용해야 하나요?
| CLI 온보딩 | macOS 앱 온보딩 | |
|---|---|---|
| 플랫폼 | macOS, Linux, Windows(네이티브 또는 WSL2) | macOS 전용 |
| 인터페이스 | 추론 설정 후 Crestodian | 추론 설정 후 Crestodian |
| 적합한 용도 | 서버, 헤드리스 환경, 완전한 제어 | 데스크톱 Mac, 시각적 설정 |
| 자동화 | 스크립트용 --non-interactive |
수동만 지원 |
| 명령어 | openclaw onboard |
앱 실행 |
대부분의 사용자는 CLI 온보딩으로 시작하는 것이 좋습니다. 어디서나 작동하며 가장 높은 수준의 제어 기능을 제공합니다.
온보딩에서 구성하는 항목
안내형 추론 단계에서는 다음 항목만 설정합니다.
- 모델 제공자 및 인증 — 감지된 액세스 또는 검증된 API 키
- 검증된 추론 — 기본 에이전트에 실제로 적용되는 모델에서 수행한 실제 완료
이 완료가 통과하면 Crestodian에서 작업 공간, Gateway, Gateway 서비스, 채널, 에이전트, Plugin 및 기타 선택적 기능을 구성할 수 있습니다.
클래식 CLI 마법사에서는 다음 항목도 추가로 구성할 수 있습니다.
- 채널(선택 사항) — Discord, Feishu, Google Chat, iMessage, Mattermost, Microsoft Teams, Telegram, WhatsApp 등을 포함한 기본 제공 및 번들 채팅 채널
- 고급 Gateway 제어 기능 — 원격 모드, 네트워크 설정 및 데몬 선택
CLI 온보딩
아무 터미널에서나 다음을 실행합니다.
openclaw onboard안내형 흐름은 기존 AI 액세스를 감지하고 후보를 순서대로 실제 테스트하며,
실패하면 다음 후보로 넘어가고 마스킹된 수동 키 입력 옵션을 제공합니다.
완료가 통과한 후에만 모델과 자격 증명을 저장한 다음 Crestodian을 시작하여
작업 공간, Gateway, 채널, 에이전트, Plugin 및 기타 선택적 기능을
구성합니다. 추론 전 Crestodian, AI 건너뛰기 경로 또는
흐름 내 클래식 전환은 없습니다. 클래식 마법사를 사용하려면 종료한 후
openclaw onboard --classic을 실행하세요.
추론을 통과하면 Crestodian에서 채널 설정을 마스킹된 터미널
마법사로 넘길 수 있습니다. 안내형 또는 클래식 제공자 설정은 열리지 않습니다.
모델 제공자나 해당 인증을 변경하려면 Crestodian을 종료하고
openclaw onboard를 실행하세요.
세부적인 모델/인증, 채널, Skills, 원격 Gateway 또는 가져오기 설정에는
openclaw onboard --classic을 사용하세요. --install-daemon을 추가하면
클래식 흐름도 선택되며 백그라운드 서비스가 한 번에 설치됩니다. 대화형 비추론
설정 및 복구에는 openclaw crestodian을 사용하세요. openclaw onboard --modern은 동일한 실제 추론 게이트를 사용하는 호환성 별칭입니다.
전체 참고 자료: 온보딩(CLI)
CLI 명령어 문서: openclaw onboard
macOS 앱 온보딩
OpenClaw 앱을 여세요. 구성된 로컬 또는 원격 Gateway에 연결할 수 있고 기본 에이전트에 이미 모델이 구성되어 있으면 앱에서 온보딩과 Crestodian을 건너뛰고 일반 에이전트 UI를 즉시 엽니다.
신규 또는 설정이 완료되지 않은 Gateway의 경우 최초 실행 흐름에서 기존 AI 액세스(Claude Code, Codex 또는 API 키)를 감지하고 최적의 옵션을 실제 테스트한 후 실제 응답을 받은 경우에만 저장합니다. 실패 시 자동으로 다음 옵션으로 넘어가며, 아무것도 찾지 못하면 검증된 수동 API 키 단계를 제공합니다. 민감한 자격 증명에는 마스킹된 입력을 사용합니다. 추론을 통과하면 Crestodian이 시작되어 나머지 구성을 지원합니다.
Gemini CLI는 설정 후 일반 에이전트에서 계속 사용할 수 있지만, 도구 미사용 프로브를 강제할 수 없으므로 이 추론 게이트에서는 제공되지 않습니다.
전체 참고 자료: 온보딩(macOS 앱)
사용자 지정 또는 목록에 없는 제공자
제공자가 목록에 없으면 openclaw onboard --classic을 실행하고
사용자 지정 제공자를 선택한 후 다음을 입력하세요.
- 엔드포인트 호환성: OpenAI 호환(
/chat/completions), OpenAI Responses 호환(/responses), Anthropic 호환(/messages) 또는 알 수 없음(세 가지를 모두 프로브하여 자동 감지) - 기본 URL 및 API 키(엔드포인트에서 요구하지 않는 경우 API 키는 선택 사항)
- 모델 ID 및 선택적 모델 별칭
여러 사용자 지정 엔드포인트가 함께 존재할 수 있으며, 각각 고유한 엔드포인트 ID가 부여됩니다.
