Open Claw 초기 설정 방법 완벽 가이드 | 몰트봇 온보딩부터 텔레그램 연동까지 (2026년 최신)

목차

• 설치 후 필수 확인 사항
• 온보딩 프로세스 시작하기 (실전편)
• LLM 연동을 위한 API 키 설정
• OpenClaw 텔레그램 연동 완벽 가이드
• 나만의 AI 비서로 커스터마이징하기
• 초기 설정 문제 해결 (트러블슈팅)
• 성공적으로 AI 비서 온보딩을 마쳤습니다
• 자주 묻는 질문

설치 후 필수 확인 사항

OpenClaw가 제대로 설치되었는지 먼저 확인하세요. 여기서 막히는 분들이 생각보다 많습니다.

체크리스트 1: 서비스 상태 확인
터미널(Mac/Linux) 또는 명령 프롬프트(Windows)를 열고 다음 명령어를 입력하세요.

openclaw status

daemon과 gateway 서비스가 모두 ‘RUNNING’ 상태로 표시되어야 합니다. 하나라도 ‘STOPPED’면 openclaw daemon restart로 재시작하세요.

체크리스트 2: 대시보드 접속
웹 브라우저에서 http://127.0.0.1:18789로 접속하세요. OpenClaw 대시보드 화면이 나타나면 성공입니다. 포트를 변경했다면 설정한 포트 번호로 접속하세요.

이 두 가지만 확인되면 다음 단계로 넘어갈 준비가 된 겁니다.

온보딩 프로세스 시작하기 (실전편)

이제 본격적인 몰트봇 온보딩 가이드입니다. 화면에 나타나는 순서대로 따라 하세요.

Step 1: 보안 경고 및 동의
처음 접속하면 “Clawdbot agents can run commands…”라는 빨간 경고창이 뜹니다. 놀라지 마세요. OpenClaw는 당신의 컴퓨터에서 파일을 읽고 명령어를 실행할 권한이 필요합니다. 로컬에서만 작동하므로 외부 유출 걱정은 없지만, 이 권한의 의미를 이해했다면 동의 버튼을 클릭하세요.

Step 2: 온보딩 모드 선택
‘QuickStart’와 ‘Manual’ 중 선택하는 화면이 나옵니다. 처음이라면 QuickStart를 추천합니다. 추천 설정으로 빠르게 시작하고, 나중에 세부 설정을 바꿀 수 있습니다. Manual은 모든 옵션을 직접 구성해야 해서 시간이 오래 걸립니다.

Step 3: 게이트웨이 설정
기본 게이트웨이 포트는 18789, 바인드 주소는 127.0.0.1입니다. 로컬 환경에서만 사용한다면 그대로 두세요. 외부에서 접속할 계획이라면 바인드 주소를 변경해야 하지만, 보안상 처음엔 권장하지 않습니다.

Step 4: LLM 제공자 선택
OpenAI, Anthropic, 그리고 로컬 OLLAMA 중 선택하세요. 처음에는 무료 크레딧을 활용할 수 있는 OpenAI나 성능이 좋은 Anthropic(Claude)을 추천합니다. 로컬 OLLAMA는 API 비용은 들지 않지만 컴퓨터 사양이 좋아야 합니다.

Step 5: API 인증 방식 선택
OAuth와 API Key 중 API Key를 선택하세요. OAuth는 편리하지만 첫 설정이 복잡합니다. API Key는 직접 복사-붙여넣기 하면 끝입니다.

여기까지 완료하면 온보딩의 80%는 끝난 겁니다.

LLM 연동을 위한 API 키 설정

API 키는 OpenClaw가 외부 AI 모델과 통신하기 위한 비밀번호입니다. 이 키가 없으면 AI 비서가 생각하고 답변을 생성할 수 없습니다.

OpenAI API 키 발급

• OpenAI Platform에 가입하고 로그인하세요.
• 왼쪽 메뉴에서 ‘API Keys’를 클릭합니다.
• ‘Create new secret key’ 버튼을 눌러 키를 생성하세요.
• 주의: 발급된 키는 한 번만 보입니다. 반드시 안전한 곳에 복사해두세요.

Anthropic (Claude) API 키 발급

• Anthropic Console에 로그인합니다.
• ‘Get API Keys’ 메뉴로 이동하세요.
• 새 키를 생성하고 복사합니다.

OpenClaw에 키 입력
온보딩 중 API Key 입력 화면에서 복사한 키를 붙여넣으세요. 온보딩을 이미 완료했다면 ~/.openclaw/openclaw.json 파일을 텍스트 에디터로 열어 직접 수정할 수 있습니다.

{
  "agents": {
    "providers": {
      "anthropic": {
        "apiKey": "여기에_키_붙여넣기"
      }
    }
  }
}

여러 LLM 제공자 동시 운영 팁
OpenClaw는 여러 LLM을 동시에 설정할 수 있습니다. 기본 모델

Excerpt

을 Claude 3.5 Sonnet으로 변경하려면 터미널에 다음 명령어를 입력하세요.

openclaw config set agents.defaults.model.primary "anthropic/claude-3-5-sonnet"

모델을 바꿀 때마다 게이트웨이를 재시작할 필요는 없습니다. 다만 주의할 점은 API 사용량에 따라 비용이 발생한다는 것입니다. 각 플랫폼의 대시보드에서 사용량을 확인하세요.

OpenClaw 텔레그램 연동 완벽 가이드

여기서 포기하는 분들이 많습니다. 하지만 실제로는 가장 간단한 단계입니다.

텔레그램 연동의 장점
책상 앞이 아니어도 핸드폰으로 AI 비서에게 명령할 수 있습니다. 출퇴근길에 이메일 요약 받기, 외출 중 파일 검색하기 등 활용 범위가 넓습니다.

Step 1: 텔레그램 BotFather로 봇 생성

• 텔레그램 앱을 열고 검색창에 ‘BotFather’를 입력하세요.
• 대화를 시작하고 /newbot 명령어를 보냅니다.
• 봇 이름을 입력하고(예: My OpenClaw), 사용자 이름을 입력하세요(끝에 ‘bot’ 필수, 예: myopenclaw_bot).
• BotFather가 HTTP API 토큰을 보내줍니다. 형식은 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 같은 긴 문자열입니다. 이 토큰을 복사하세요.

Step 2: OpenClaw에 텔레그램 채널 설정
터미널을 열고 OpenClaw 설치 디렉토리로 이동한 후 다음 명령어를 입력하세요.

openclaw configure

대화형 설정 프로세스가 시작됩니다:

• ‘channels’ 선택
• ‘add new channel’ 선택
• ‘telegram’ 선택
• 복사한 봇 토큰을 붙여넣고 Enter
• 설정을 저장하고 나옵니다

Step 3: 서비스 재시작 및 확인
설정 적용을 위해 게이트웨이를 재시작합니다.

openclaw gateway restart

재시작 후 텔레그램에서 생성한 봇을 검색하고 /start 명령어를 보내세요. 페어링 코드(예: JN4MSY23)가 나타나면 터미널에서 승인합니다.

openclaw pairing approve telegram JN4MSY23

이제 봇에게 “안녕”이라고 말을 걸어보세요. OpenClaw가 응답하면 연동 성공입니다.

Reddit의 한 사용자는 “텔레그램 봇이랑 작동하게 하는 거에서 계속 막히네”라고 고민했지만, 페어링 승인 단계를 놓쳤던 게 문제였습니다(출처). 이 단계만 꼭 기억하세요.

나만의 AI 비서로 커스터마이징하기

기본 설정을 넘어 나만의 비서로 만들어보세요. 성격과 말투까지 바꿀 수 있습니다.

성격 및 톤 설정
~/.openclaw/openclaw.json 파일을 열어 system_prompt 부분을 찾으세요. 여기에 AI 비서의 역할과 말투를 정의합니다.

{
  "agents": {
    "system_prompt": "당신은 항상 유머를 잃지 않는 유능한 비서입니다. 답변은 간결하되 친근하게 작성하세요."
  }
}

이렇게 설정하면 AI 비서가 딱딱한 톤 대신 친근하게 대답합니다.

설정 파일 구조 이해
~/.openclaw/ 디렉토리가 모든 설정의 중심입니다. openclaw.json 파일에는 Gateway, LLM 제공자, 채널, 에이전트 설정이 모두 들어 있습니다. 직접 수정할 때는 JSON 문법을 지켜야 하며, 쉼표나 따옴표를 빼먹으면 작동하지 않습니다.

데이터 위치
스킬, 메모리 등 AI 비서의 학습 데이터는 ~/.openclaw/memory/에 저장됩니다. 백업이 필요하다면 이 디렉토리를 통째로 복사하세요.

초기 설정 문제 해결 (트러블슈팅)

자주 겪는 문제들과 해결 방법입니다.

문제	원인	해결 방법
API 키가 인식되지 않아요	따옴표나 공백 오류	openclaw.json 파일에서 키 확인 후 openclaw daemon restart
텔레그램 봇이 응답하지 않아요	게이트웨이 미작동 또는 토큰 오류	openclaw status로 상태 확인, openclaw gateway restart 실행
설정을 변경했는데 적용이 안 돼요	서비스 재시작 필요	openclaw daemon restart 또는 openclaw gateway restart
갑자기 작동을 멈췄어요	로그 확인 필요	openclaw logs daemon 또는 openclaw logs gateway로 에러 메시지 확인

문제 1: API 키가 인식되지 않아요
~/.openclaw/openclaw.json 파일을 열어 API 키가 정확히 입력되었는지 확인하세요. 따옴표나 공백이 잘못 들어가지 않았는지 체크하고, 수정 후에는 반드시 openclaw daemon restart로 데몬을 재시작하세요.

문제 2: 텔레그램 봇이 응답하지 않아요
openclaw status로 게이트웨이가 정상 작동 중인지 확인합니다. RUNNING 상태가 아니라면 openclaw gateway restart로 재시작하세요. 봇 토큰이 정확한지도 다시 확인하고, 페어링 승인을 놓쳤다면 /start 명령어를 다시 보내세요.

문제 3: 설정을 변경했는데 적용이 안 돼요
대부분의 설정 변경 후에는 관련 서비스를 재시작해야 합니다. daemon 관련 설정은 openclaw daemon restart, gateway나 채널 관련 설정은 openclaw gateway restart를 실행하세요.

문제 4: 갑자기 작동을 멈췄어요
openclaw logs daemon 또는 openclaw logs gateway 명령어로 로그를 확인하여 에러 메시지를 찾아보세요. 문제 해결이 어려울 경우, 공식 GitHub Issues에 로그와 함께 질문하는 것이 가장 빠릅니다. 2026년 1월 30일 리브랜딩 이후 보안 업데이트로 auth: “none” 모드가 제거되었으므로, 이전 버전에서 업데이트한 경우 인증 설정을 다시 확인하세요.

성공적으로 AI 비서 온보딩을 마쳤습니다

여기까지 따라오셨다면 개인 AI 비서 기본 설정이 완료된 겁니다. 온보딩부터 API 키 설정, 텔레그램 연동까지 핵심 단계를 모두 마쳤습니다.

이제 당신만의 AI 비서를 일상에서 활용할 차례입니다. 다음 단계로 OpenClaw의 강력한 ‘스킬’ 기능을 탐색하거나, 파일 정리, 이메일 요약 등 일상적인 작업을 자동화하는 방법을 알아보세요. 한 사용자는 “하루 만에 6,000개 이메일 정리”를 완료했다고 후기를 남겼습니다(출처).

설정 중 문제가 발생하거나 더 많은 활용법을 알고 싶다면 공식 GitHub 저장소나 Discord 채널에 참여하여 다른 사용자들과 정보를 교류해 보세요.

자주 묻는 질문

Q1: Open Claw 초기 설정에 시간은 얼마나 걸리나요?
이 가이드를 따라 한다면 API 키 발급 시간을 포함하여 약 10~15분 내에 모든 초기 설정을 완료할 수 있습니다. 텔레그램 연동까지 포함해도 20분이면 충분합니다.

Q2: 비개발자도 몰트봇 온보딩 가이드를 따라 할 수 있나요?
네, 가능합니다. 이 가이드는 터미널 명령어 몇 개를 복사-붙여넣기 하는 수준으로 구성되어 있어 비개발자도 충분히 따라 할 수 있습니다. JSON 파일 수정도 텍스트 에디터만 사용할 수 있으면 됩니다.

Q3: 텔레그램 말고 다른 메신저도 연동 가능한가요?
네, OpenClaw는 Discord, WhatsApp, LINE, Slack 등 다양한 채널 연동을 지원합니다. openclaw configure 명령어를 통해 다른 채널도 비슷한 방식으로 추가할 수 있습니다. 각 채널마다 봇 생성 방법만 다를 뿐, 설정 프로세스는 거의 동일합니다.

Q4: API 사용 비용은 얼마나 나오나요?
API 비용은 사용량에 따라 다릅니다. OpenAI와 Anthropic 모두 신규 가입 시 일정량의 무료 크레딧을 제공하므로 초기 테스트에는 부담이 없습니다. 일반적인 개인 사용(하루 50~100회 대화)은 월 5~15달러 수준입니다. 사용량은 각 플랫폼의 대시보드에서 실시간으로 확인할 수 있습니다.