안녕하세요.
최근 OpenClaw 최신 버전v2026.7.1-beta.5 이후 계열에서는 온보딩 방식이 기존 메뉴형 화면에서 Crestodian 기반 대화형 온보딩 방식으로 변경되었습니다.
기존 강의 화면과 다르게 보여서 당황하실 수 있어, 아래처럼 안내드립니다.
적용 대상
- 최신 Docker 이미지를 새로 pull 해서 설치/실습하는 수강생
- 기존 강의 화면과 달리, openclaw onboard 실행 시 Crestodian TUI 화면이 먼저 나오는 수강생
아래에 해당하지 않는 경우:
- 예전 Docker 이미지를 그대로 사용 중인 수강생은
기존 강의 화면과 거의 동일하게 진행될 수 있으므로,
강의 내용대로 따라오시면 됩니다.
최신 버전에서 바뀐 점
기존에는 openclaw onboard 실행 후 바로 모델 선택 메뉴가 보이는 경우가 많았지만,
최신 버전에서는 먼저 Crestodian이라는 설정/수리용 시스템 에이전트가 실행됩니다.
예를 들어, 아래와 같은 안내 화면이 먼저 보일 수 있습니다.
- "Hi, I'm Crestodian — let's hatch your agent."
- "Say yes and I'll set all of that up now."
- "No usable model provider is configured, so the agent cannot answer yet. Configure a model provider now? Say yes or no."
즉, 최신 버전에서는 yes를 두 번 입력해야 기존의 모델 선택 흐름으로 넘어가는 경우가 있습니다.
최신 버전 온보딩 진행 방법
최신 버전에서 openclaw onboard를 실행했을 때는 아래처럼 진행해 주세요.
1. Crestodian 첫 화면이 나오면 yes 입력
처음 아래와 비슷한 문구가 보이면:
- "Hi, I'm Crestodian — let's hatch your agent."
- "Say yes and I'll set all of that up now."
여기서 터미널에 아래처럼 입력합니다.
yes2. 모델 프로바이더 설정 여부를 다시 물으면 yes 한 번 더 입력
그 다음 아래와 비슷한 문구가 나올 수 있습니다.
- "No usable model provider is configured, so the agent cannot answer yet."
- "Configure a model provider now? Say yes or no."
여기서 다시 한 번 아래처럼 입력합니다.
yes즉, 최신 버전에서는 yes → yes 순서로 두 번 입력 후 엔터를 쳐야 모델 선택/키 입력 단계로 넘어가는 경우가 있습니다.
3. 이후부터는 강의 흐름과 동일
그 다음부터는:
- 사용할 모델 선택
- Gemini API 키 입력
- 기본 에이전트 설정
등의 흐름으로 이어지며,
이 부분은 강의에서 설명한 온보딩 목적과 크게 다르지 않습니다.
## 온보딩 완료 기준
Gemini API 키 입력 및 설정이 끝나면, 아래와 비슷한 메시지가 보일 수 있습니다.
- "Your agent is ready."
- "Model: google/gemini-2.5-flash."
- "Gateway: running at ws://127.0.0.1:18789."
- "Say talk to agent to meet your agent right here, or help for everything I can do."
이 화면이 보이면 온보딩은 정상적으로 완료된 상태입니다.
즉:
- 모델 설정 완료
- 게이트웨이 연결 완료
- 기본 에이전트 준비 완료
상태라고 보시면 됩니다.
온보딩 완료 후 어떻게 빠져나오면 되나요?
최신 버전에서는 온보딩이 끝난 뒤에도 Crestodian TUI 화면이 그대로 남아 있을 수 있습니다.
이 경우에는:
- Ctrl + C
- 다시 한 번 Ctrl + C
처럼 Ctrl + C를 두 번 눌러 TUI에서 빠져나오면 됩니다.
강의에서는 예전 버전 기준 화면이라 이 부분이 직접적으로 나오지 않을 수 있지만,
최신 버전 수강생은 온보딩 완료 후 Ctrl + C를 두 번 눌러 종료하시면 됩니다.
정리
최신 버전 수강생은 아래만 기억하시면 됩니다.
1. openclaw onboard 실행
2. Crestodian 안내 화면이 나오면 yes
3. 모델 프로바이더 설정 여부를 물으면 다시 yes
4. Gemini API 키 입력 후 설정 진행
5. "Your agent is ready." 메시지가 보이면 온보딩 완료
6. 마지막에 Ctrl + C를 두 번 눌러 빠져나오기
기존 수강생 / 구버전 사용자는?
- 최신 이미지를 pull 하지 않은 수강생
- 예전 버전 Docker 이미지를 그대로 사용 중인 수강생
은 기존 강의 화면과 유사할 수 있으므로,
강의 내용대로 그대로 진행하시면 됩니다.
마무리
정리하면,
최신 버전에서는 온보딩 UI가 Crestodian 기반 대화형 방식으로 바뀌었고, 그에 따라 yes를 두 번 입력한 뒤 모델 선택/키 입력을 진행하고, 마지막에는 Ctrl + C를 두 번 눌러 종료하는 흐름으로 바뀌었다고 이해하시면 됩니다.
최신 버전 수강생분들은 이 공지를 참고해서 진행해 주세요.