OpenClaw 시작하기: 내 환경에 맞는 온보딩 경로 선택하기

새로운 도구를 도입할 때 가장 번거로운 일이 무엇인가요? 아마 복잡한 초기 설정일 거예요. 환경 변수를 맞추고 설정 파일을 하나하나 수정하다 보면, 정작 중요한 개발은 시작하기도 전에 지치곤 하죠. OpenClaw는 이런 불편함을 줄이기 위해 간단한 온보딩 과정을 제공해요.

필요한 것

시작하기 전에 본인의 환경이 아래 조건에 맞는지 확인해 주세요.

• CLI wizard 사용 시: macOS, Linux, 또는 Windows (WSL2)
• macOS app 사용 시: Apple silicon 또는 Intel Mac

빠른 시작

OpenClaw를 설치하고 설정하는 가장 빠른 방법은 두 가지예요. 5분 안에 설정을 마칠 수 있습니다.

1. CLI 온보딩 위저드

Gateway, workspace, channels, skills를 직접 세밀하게 제어하고 싶다면 CLI를 사용하세요. 터미널에서 아래 명령어를 입력하면 위저드가 시작됩니다.

openclaw onboard

2. macOS 앱 온보딩

Apple 환경에서 가이드에 따라 시각적으로 설정을 진행하고 싶다면 macOS 앱을 사용해 보세요. 처음 사용자를 위한 친절한 안내를 받을 수 있습니다.

Custom Provider 설정하기

목록에 없는 특정 엔드포인트를 연결해야 할 때가 있죠? 표준 OpenAI 또는 Anthropic API를 노출하는 호스팅 프로바이더를 사용한다면 CLI 위저드에서 Custom Provider를 선택하면 돼요. 다음 정보를 입력하게 됩니다.

• 호환성 선택: OpenAI-compatible, Anthropic-compatible 또는 Unknown (자동 감지) 중 하나를 고르세요.
• 접속 정보: Base URL과 API key (필요한 경우)를 입력합니다.
• 모델 정보: Model ID와 선택 사항인 alias를 입력합니다.
• Endpoint ID: 여러 커스텀 엔드포인트를 함께 사용할 수 있도록 ID를 지정합니다.

문제 해결

설정 중에 문제가 생겼나요? 소스 문서에서 제안하는 해결 방법입니다.

• 지원되지 않는 엔드포인트: 사용하는 프로바이더가 목록에 없다면 CLI 위저드의 Custom Provider 옵션을 통해 직접 API 정보를 입력해 보세요.
• 호환성 확인: 프로바이더의 API 타입을 잘 모를 때는 Unknown을 선택하면 OpenClaw가 자동으로 감지를 시도해요.

설정에 대해 더 궁금한 점이 있다면 AI Setup Assistant에게 물어보세요!

다음 단계

• Onboarding Wizard (CLI) 상세 가이드
• openclaw onboard 명령어 참조
• macOS App 온보딩 상세 가이드