뽀야와 함께하는 오픈클로 첫걸음 · 2026.7.1-2 기준

오픈클로 설치부터
텔레그램 · 슬랙 연동까지

처음 해보는 분도 따라만 하면 돼요. 약속해요 🐾

오늘 할 일 한눈에 보기

총 5단계예요. 하나씩 끝낼 때마다 체크해볼까요?

• 01준비물 챙기기 — 컴퓨터에 기본 도구 깔기~5분
• 02오픈클로 깔기 — 한 줄 복붙이면 끝~2분
• 03첫 세팅 — 로그인하고 뽀야 두뇌 연결하기~3분
• 04텔레그램에 봇 만들기 — 뽀야한테 얼굴 만들어주기~5분
• 05드디어 대화! — "안녕 뽀야!" 보내보기~3분
• 06슬랙에 데려오기 — 팀이 같이 쓰는 자리에 앉히기~10분
• +보너스 — 봇 성격을 내 맘대로 바꾸기읽기자료

준비물 챙기기 🎒

시작하기 전에 딱 두 가지만 깔면 돼요

🪟 윈도우 사용자는 여기부터!

윈도우에서 오픈클로 설치, 생각보다 훨씬 간단해요.
wsl --install -d Ubuntu 명령어 한 줄로 리눅스 환경이 세팅되고,
그 다음은 맥과 완전히 동일합니다!

🍎 맥 사용자는 이 페이지 스킵! → "다음" 버튼 누르세요

키보드에서 Windows 키 → "PowerShell" 검색 → "관리자로 실행" 클릭

WSL과 Ubuntu가 함께 설치돼요. 끝나면 컴퓨터를 재시작하세요.

시작 메뉴에서 "Ubuntu" 검색 → 클릭하면 터미널이 열려요.

처음 실행하면 사용자 이름/비밀번호를 만들라고 해요:

• 사용자 이름: 영어 소문자 (예: myname)
• 비밀번호: 아무거나 (입력할 때 화면에 안 보이는 게 정상!)

Node.js가 없으면 자동으로 설치해줘요. 약 7분 정도 걸려요.

🪟 WSL 없이, 파워셸에서 바로 설치하기

앞 슬라이드의 WSL2가 잘 안 되거나 부담스러우면 이 방법만 해도 돼요.
윈도우에 원래 들어있는 파워셸에서 명령어 한 줄이면 끝나요.

🍎 맥 사용자는 이 페이지 스킵! → "다음" 버튼 누르세요

키보드에서 Windows 키 → "PowerShell" 검색 → 그냥 클릭

💡 파워셸은 윈도우에 기본으로 들어있어요. 따로 설치할 필요 없어요. (PowerShell 5 이상이면 OK)

💡 파워셸에서 붙여넣기는 마우스 오른쪽 클릭이에요. Ctrl+V가 아니에요!

공식 윈도우 설치 스크립트예요. Node.js가 없으면 알아서 같이 깔아줘요.

winget → Chocolatey → Scoop 순서로 시도하고, 셋 다 없으면 공식 Node 24를 통째로 내려받아 PATH에 넣어줘요. 그래서 Node를 미리 안 깔아도 돼요.

설치 직후엔 openclaw 를 못 찾는 게 정상이에요. PATH가 새 창부터 적용되거든요.

Node.js 설치하기

오픈클로가 돌아가려면 Node.js가 필요해요. 24 LTS 권장이고, 22.22.3 이상도 괜찮아요.

1 터미널 열기

Cmd + Space → "터미널" 또는 "Terminal" 입력 → Enter

2 Homebrew맥에서 프로그램을 쉽게 깔아주는 도우미예요. 앱스토어처럼 "이거 깔아줘!" 하면 알아서 깔아줘요. 근데 마우스 대신 글자로!로 설치 (권장)

Homebrew가 없는 경우, 먼저 이걸 복사해서 터미널에 붙여넣기:

터미널 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

비밀번호를 물어보면 맥 로그인 비밀번호를 입력하세요. (화면에 안 보이는 게 정상!)

Homebrew 설치 후 (또는 이미 있는 경우):

터미널 brew install node

3 설치 확인

터미널 node --version
v24.x.x ← 숫자가 나오면 성공! 🎉

🔧 여기서 막히는 경우 (클릭하면 열려요)

❌ "brew: command not found"

Homebrew 설치가 안 된 거예요.

→ 해결법:

위의 Homebrew 설치 명령어를 먼저 실행하세요. 설치 후 터미널을 껐다 다시 열어야 인식돼요!

Apple Silicon 맥(M1/M2/M3/M4)이면 추가로 이것도 실행:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

❌ "xcode-select: note: no developer tools were found"

Xcode 명령줄 도구가 필요해요.

→ 해결법: 팝업이 뜨면 "설치" 클릭. 안 뜨면 수동으로:

xcode-select --install

❌ "node: command not found" (설치했는데 안 됨)

→ 해결법: 터미널을 완전히 껐다가 다시 열어보세요.

그래도 안 되면 nodejs.org에서 .pkg 파일을 직접 다운받아 설치해도 돼요.

Homebrew 없이도 nodejs.org에서 직접 .pkg 파일을 다운받아 설치할 수 있어요!

오픈클로 설치하기 🦞

공식 자동 설치 스크립트로 한 줄이면 끝! (수동 설치는 npm터미널에서 프로그램을 깔아주는 도구예요. 앱스토어에서 "다운로드" 누르는 것처럼, 여기선 글자로 "이거 깔아!" 하면 돼요.으로도 가능)

전체 진행률: 35%

1 자동 설치 스크립트 실행

터미널 curl -fsSL https://openclaw.ai/install.sh | bash

맥도 동일해요! 이 한 줄이면 끝.

2 설치 확인

터미널 openclaw --version
OpenClaw 2026.7.1-2 (0790d9f) ← 성공! 🎉
※ 뒤 숫자·괄호 안 글자는 설치 시점마다 달라요. 이름이 나오면 성공!

온보딩 시작 ⚙️

보안 동의 → AI 모델 선택 → 게이트웨이 설정을 한 번에!

전체 진행률: 45%

이 한 줄이면 돼요. 설정 마법사가 시작되고, 하나씩 물어보는 대로 답하면 됩니다!

온보딩을 시작하면 가장 먼저 보안 경고 화면이 나타나요.

보안 동의를 넘기면 설정 방식을 고르는 화면이 나와요. 네 개 중에 하나예요.

방향키 ↑ ↓ 로 움직이고 Enter 로 선택해요. 마우스로는 안 골라져요!

QuickStart를 고르면 기본 설정 요약이 나와요. 그냥 넘어가면 됩니다!

AI 모델 선택하기 🧠

뽀야의 두뇌를 골라주세요! 어떤 AI를 쓸 건가요?

전체 진행률: 55% — 핵심 단계!

이제 "Model/auth provider" 선택 화면이 나타나요.
뽀야한테 어떤 AI 두뇌를 연결할지 고르는 거예요!

※ Claude CLI는 Provider 목록 1티어가 아니라 Anthropic provider 안의 인증 방식이에요. 그래서 먼저 Anthropic을 고르고, 다음 단계에서 인증 방식을 Claude CLI로 선택하면 돼요.

※ 실제 항목 라벨/순서는 OpenClaw 버전에 따라 살짝 다를 수 있어요. 핵심은 Anthropic → Claude CLI 두 단계.

어떤 걸 고르면 되나요?

선택 후 인증 방법

설정 마무리 + 건강 체크 🩺

나머지 질문에 답하고, 모든 게 잘 됐는지 확인해요

전체 진행률: 60%

AI 모델을 골랐으면, 마법사가 몇 가지 더 물어봐요. 대부분 Enter(기본값)로 넘기면 됩니다!

텔레그램 봇 만들기 🤖

텔레그램에서 뽀야와 대화하려면, "봇 껍데기"를 먼저 만들어야 해요

전체 진행률: 70% — 거의 다 왔어요!

BotFather텔레그램에서 봇을 만들어주는 공식 봇이에요. 봇을 만드는 봇! 🤯 얘한테 "/newbot" 이라고 말하면 새 봇이 뚝딱 만들어져요.에게 봇 만들어달라고 하기

텔레그램에는 @BotFather라는 특별한 봇이 있어요.
이 친구한테 말하면 새 봇을 만들어줘요. (봇을 만드는 봇...! 🤯)

텔레그램 검색창에 botfather를 검색하세요.

파란 체크 ✅ 표시가 있는 공식 계정이에요. 가짜가 많으니 꼭 확인!

BotFather 채팅창에 /newbot을 입력하고 보내세요:

BotFather가 "How are we going to call it?" 하고 물어봐요.
봇 이름을 입력하면, 다음으로 유저네임을 물어봐요.

성공하면 BotFather가 축하 메시지와 함께 봇 토큰을 보내줘요:

오픈클로에 텔레그램 연결하기

방금 만든 봇 토큰을 오픈클로에 등록해요.

토큰을 명령어에 직접 쓰지 않아요. 메뉴가 뜨고, 물어보는 대로 붙여넣으면 됩니다.

그다음 순서대로 이렇게 흘러가요:

게이트웨이뽀야(AI)와 텔레그램을 이어주는 "다리"예요. 이 다리가 켜져 있어야 메시지가 왔다갔다 해요. 다리 끊기면(꺼지면) 봇이 대답 안 해요! 실행 + 첫 대화! 🚀

마지막 단계예요. 진짜 거의 다 된 거예요!

전체 진행률: 90% — 조금만 더!

온보딩에서 daemon을 설치했으면 이미 돌아가고 있을 수 있어요!

로그가 쭉 올라오면 성공이에요!

1. 텔레그램 검색창에 @내봇유저네임 검색 (예: @ppoya_test_bot)
2. /start 버튼을 누르거나 직접 입력
3. 아무 말이나 보내보세요! 예: "안녕 뽀야!"

슬랙에 데려오기 💬

팀이 같이 쓰는 자리에 봇을 앉혀요

api.slack.com/apps 접속 → Create New App → From an app manifest → 내 워크스페이스 선택

{
  "display_information": {
    "name": "뽀야",
    "description": "OpenClaw AI 에이전트"
  },
  "features": {
    "bot_user": { "display_name": "bboya", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "assistant_view": {
      "assistant_description": "OpenClaw AI 에이전트",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

Next → 미리보기 확인 → Create 클릭. 이러면 권한·이벤트·Socket Mode가 한 번에 다 켜진 상태로 만들어져요.

매니페스트엔 영문 아이디를 넣었으니, 슬랙에서 @뽀야 처럼 한글로 부르려면 한 번 더 손봐야 해요.

왼쪽 메뉴 App Home → Your App's Presence in Slack → Edit → Display Name (Bot Name) 을 한글로 → Save

Socket Mode는 켜졌지만 앱 토큰은 자동으로 안 만들어져요. 직접 발급해요.

왼쪽 메뉴 Basic Information → 아래로 스크롤 → App-Level Tokens → Generate Token and Scopes

이름은 아무거나(bboya) → Add permission by Scope 에서 connections:write 하나만 선택 → Generate

왼쪽 메뉴 Install App → Install to Workspace → 권한 허용

Bot User OAuth Token 이 나와요 → 이것도 메모장에! xoxb- 로 시작해요.

토큰을 명령어에 직접 쓰지 않아요. 메뉴가 뜨고, 물어보는 대로 붙여넣으면 됩니다.

그다음 순서대로 이렇게 흘러가요:

슬랙 왼쪽 사이드바 맨 아래 앱 영역에서 내 봇을 찾아 눌러요.

💡 "앱"이 안 보이면 — 그 영역의 점 3개(⋯) → 필터 → "모두" 선택

DM 창에 안녕? 하고 보내보세요.

DM 말고 채널에서 쓰려면 초대를 해야 해요. 사람이랑 똑같아요.

그다음 @내봇 안녕 처럼 이름을 불러서 말 걸어요. 채널에서는 불러야 대답해요 — 안 그러면 사람들 대화에 계속 끼어들거든요.

축하해요!
설치 완료!

여러분은 이제 오픈클로 사용자예요 🦞

오늘 한 일 정리

• WSL2 또는 파워셸 설치 (윈도우 사용자) ✅
• Node.js 설치 ✅
• 오픈클로 설치 (curl ... | bash) ✅
• 온보딩 + OAuth 로그인 (openclaw onboard --install-daemon) ✅
• 텔레그램 봇 생성 (BotFather) ✅
• 텔레그램 채널 연결 (openclaw channels add) ✅
• 게이트웨이 실행 + 텔레그램 첫 대화 ✅
• 슬랙 채널 연결 (선택) ✅

유용한 명령어 모음

보너스: SOUL.md로 봇 성격 꾸미기

함께 보면 좋은 자료

다음 시간 예고

전체 트러블슈팅 요약 🔧

각 단계에서 이미 설명했지만, 한눈에 보고 싶을 때 여기를 보세요.

슬랙 설정 4줄 마무리 ⚙️

설치가 끝났으면, 이 네 줄까지 넣어야 워크숍 때처럼 굴러가요

내 openclaw.json의 슬랙 설정(channels.slack)에 아래 네 개 넣어줘.

{
  "dmPolicy": "pairing",
  "groupPolicy": "open",
  "allowBots": true,
  "replyToMode": "all"
}

각각 무슨 뜻이냐면