OpenClaw(오픈클로) 온보딩 위저드로 에이전트 환경 구축 가이드

OpenClaw 시작하기: 온보딩 위저드 가이드

OpenClaw는 macOS, Linux, 그리고 Windows(WSL2 권장) 환경에서 사용할 수 있는 강력한 에이전트 도구입니다. 복잡한 설정 때문에 망설이셨나요? 온보딩 위저드를 사용하면 클릭과 입력 몇 번만으로 간편하게 설치를 끝낼 수 있습니다.

1. 첫 실행 및 모드 선택

먼저 터미널을 열고 아래 명령어를 입력하여 시작하세요.

openclaw onboard

명령어를 실행하면 QuickStart와 Advanced 중 하나를 선택하는 화면이 나타납니다.

• QuickStart (추천): 복잡한 설정은 기본값(Default)으로 두고 필수 사항만 설정합니다. 초보자에게 가장 적합합니다.
• Advanced: 게이트웨이 포트, 네트워크 노출 여부 등 세부 사항을 직접 제어하고 싶은 전문가를 위한 모드입니다.

2. 핵심 설정 단계 (Local 모드 기준)

① 모델 및 인증 (Model/Auth)

에이전트의 '두뇌' 역할을 할 AI 모델을 연결하는 단계입니다.

• Anthropic API Key: 가장 안정적인 성능을 보여주므로 강력 추천합니다.
• OpenAI API Key: 키를 입력하면 자동으로 .env 파일에 저장됩니다.
• 기타: Gemini, Vercel, Cloudflare 등 다양한 프록시 모델을 지원합니다.

② 워크스페이스 (Workspace)

에이전트가 작업할 공간을 지정합니다. 웬만하면 기본값인 ~/.openclaw/workspace를 사용하는 것이 나중에 관리하기 편합니다.

③ 게이트웨이 (Gateway)

에이전트와 통신하는 통로를 설정합니다. 보안을 위해 Token 인증 방식을 유지하는 것이 안전합니다.

④ 채널 연결 (Channels) - 선택 사항

• 메신저 연결: WhatsApp, Telegram, Discord 등을 토큰이나 QR 코드로 연결할 수 있습니다.
• Brave Search API: 에이전트가 실시간 웹 검색을 수행하게 하려면 이 키를 등록하세요.

⑤ 데몬 설치 (Daemon Install)

컴퓨터를 재부팅해도 OpenClaw가 배경에서 계속 실행되도록 설정합니다. macOS는 LaunchAgent로, Linux/WSL2는 systemd 서비스로 깔끔하게 등록됩니다.

3. 유용한 꿀팁 및 문제 해결

• 빠른 대화 시작: 채널 설정이 번거롭다면 openclaw dashboard를 입력해 브라우저 대시보드를 바로 여세요.
• 설정 수정: 처음부터 다시 할 필요 없이 openclaw configure 명령어로 특정 부분만 바꿀 수 있습니다.
• 자가 진단: 작동이 이상하다면 openclaw doctor를 실행해 문제 원인을 파악하세요.
• 초기화: openclaw onboard --reset을 사용하면 깨끗하게 다시 시작할 수 있습니다. (기존 파일은 휴지통으로 안전하게 이동됩니다.)

💡 설정 완료 후: 위저드가 요약 내용과 함께 모바일 앱 설치 안내를 보여줄 것입니다. 외부에서도 내 에이전트를 관리하고 싶다면 앱 설치까지 꼭 마무리해보세요!