온보딩 (Onboarding)은 새 집에 이사할 때 전기·수도·인터넷을 처음 연결하는 과정 같은 것 — AI 에이전트가 처음 실행될 때 어떤 모델을 쓸지, API 키는 무엇인지 등 기본 설정을 마법사(Wizard) 형태로 안내해 완성하는 초기 세팅 단계.
온보딩은 새 스마트폰을 처음 켰을 때 언어·Wi-Fi·계정을 하나씩 설정하는 '초기 설정 마법사' 와 똑같다. AI 에이전트도 처음 실행하면 '어떤 AI 모델을 쓸 건지', 'API 키는 무엇인지', '기본 채널 (Channel) 은 어디인지' 같은 질문을 차례로 물어보며 사용 가능한 상태로 만들어 준다. 이 과정을 건너뛰면 에이전트가 아무것도 할 수 없는 빈 껍데기 상태로 남는다.
1인 비즈니스(1인 사이트 운영)를 운영하다 보면 온보딩을 여러 곳에서 만난다. 블로그에 AI 챗봇을 붙일 때 처음 API 키를 입력하는 화면, 뉴스레터 자동화 도구를 처음 연결할 때 계정 권한을 허용하는 단계, SaaS 서비스에 신규 가입한 사용자가 프로필·목적·알림 설정을 완료하는 흐름, 커뮤니티 플랫폼에서 새 멤버가 닉네임·관심사를 등록하는 과정이 모두 온보딩이다. OpenClaw 에서는 openclaw onboard 명령어를 실행하면 모델 프로바이더 (Model Provider) 와 API 키를 선택하는 초기 마법사가 시작된다.
초보자가 자주 혼동하는 점은 온보딩을 '회원가입'과 동일하게 보는 것이다. 회원가입은 계정을 만드는 한 단계일 뿐이고, 온보딩은 그 이후 '실제로 쓸 수 있는 상태'까지 안내하는 전체 흐름을 가리킨다. 설정 항목이 많아 보여도 온보딩을 끝까지 완료해야 에이전트 (Agent) 가 게이트웨이 (Gateway), 채널, 툴 (Tool) 에 제대로 연결되어 작동한다.
AI 에이전트를 직접 만들고 24시간 운영하는 법을 단계별 강의로 배워보세요.
