openclaw onboard로 쉽고 빠르게 설정하기

새로운 도구를 처음 설치할 때 설정 과정이 너무 복잡하면 시작하기도 전에 지치곤 해요. 환경 변수를 하나하나 입력하거나 설정 파일을 직접 수정하는 일은 번거롭고 실수하기도 쉽죠.

복잡한 과정 없이 바로 도구를 사용해보고 싶은 개발자라면 이 가이드가 도움이 될 거예요. openclaw onboard 명령어를 통해 로컬이나 원격 Gateway 설정을 간단하게 끝낼 수 있습니다.

필요한 것

시작하기 전에 다음 항목이 준비되었는지 확인해 주세요.

• openclaw CLI 설치
• 원격 모드 사용 시 연결 가능한 Gateway URL

빠른 시작

5분 안에 설정을 마치고 첫 번째 대화를 시작하는 방법이에요. 원하는 방식에 맞춰 명령어를 선택해 보세요.

# 기본적인 대화형 설정 위저드를 시작합니다.
openclaw onboard

# 최소한의 질문으로 빠르게 설정을 마칩니다 (Gateway 토큰 자동 생성).
openclaw onboard --flow quickstart

# 포트, 바인딩, 인증 등을 직접 상세하게 설정합니다.
openclaw onboard --flow manual

# 원격 Gateway에 연결하도록 설정합니다.
openclaw onboard --mode remote --remote-url ws://gateway-host:18789

가장 빠르게 채팅을 시작하고 싶다면 openclaw dashboard를 입력해 보세요. 채널 설정 없이 바로 Control UI를 확인할 수 있습니다.

문제 해결

설정 과정에서 발생할 수 있는 상황과 해결 방법이에요.

스크립트에서 명령어가 멈추는 경우 --json 플래그를 사용하더라도 위저드는 여전히 대화형(interactive)으로 동작해요. 스크립트나 자동화 환경에서 사용하려면 --non-interactive 플래그를 반드시 추가해야 합니다.

설정 이후 단계 설정을 마친 후에는 다음 명령어를 통해 추가 구성을 하거나 에이전트를 관리할 수 있어요.

openclaw configure
openclaw agents add <name>

설정 중에 궁금한 점이 생기면 AI Setup Assistant에게 언제든 물어보세요.

다음 단계

• Onboarding Wizard (CLI)
• CLI Onboarding Reference
• CLI Automation
• Onboarding (macOS App)