OpenClaw 완전 정복: 이름 변천사부터 설치·사용까지 초보자도 따라하는 실전 가이드

OpenClaw(Clawdbot → Moltbot → OpenClaw)의 인기 배경과 이름 변천, 안전한 설치·사용법을 단계별로 정리했습니다.
IT·과학
저자

Ikmyungterran

공개

2026년 2월 1일

0. 한 줄 요약

OpenClaw는 로컬에서 동작하는 개인 AI 에이전트입니다. 이 글은 이름 변천사 → 배경지식 → 설치 준비 → VPS 보안 세팅 → 설치·온보딩 → 대시보드 접속 → 채널 연결 → 유지보수 순서로, 자세히 정리했습니다.

1. OpenClaw 이름 변천사와 인기 배경 (짧고 핵심만)

1.1 이름 변천사

  • Clawdbot → Moltbot → OpenClaw 순서로 이름이 바뀌었습니다.
  • 이유는 브랜드·상표 이슈가 가장 큰 배경이었습니다.

1.2 왜 이렇게 빨리 퍼졌을까?

  • 내 PC/서버에서 직접 실행되는 AI라는 콘셉트가 강력했습니다.
  • 텔레그램/디스코드/WhatsApp 같은 채널과 연결해 “내가 만든 개인 비서”를 쉽게 운영할 수 있기 때문입니다.
  • 빠른 확산과 함께 가짜 설치본/사칭 이슈도 언급되므로, 설치는 공식 경로만 사용하는 것이 중요합니다.

OpenClaw 확산 배경을 상징하는 이미지

2. 초보자를 위한 배경지식

2.1 VPS란?

  • VPS(가상 서버)는 “24시간 켜져 있는 내 전용 컴퓨터”라고 생각하면 됩니다.
  • 내 노트북은 끄면 프로그램이 멈추지만, VPS는 항상 켜져 있어 봇이 끊기지 않습니다.

2.2 터미널(또는 CLI)이란?

  • 마우스 없이 키보드로 명령을 입력하는 화면입니다.
  • 윈도우에서는 PowerShell, 맥에서는 Terminal이라고 부릅니다.

2.3 SSH가 뭐고, 왜 쓰나요?

  • SSH는 내 컴퓨터에서 원격 서버(VPS)를 안전하게 조종하는 암호화된 통로입니다.
  • 예를 들어, ssh root@123.45.67.89 라고 입력하면 내 컴퓨터가 VPS로 연결됩니다.

SSH를 쓰는 이유

  1. 보안: 모든 통신이 암호화됩니다.
  2. 원격 조작: 서버에 직접 접속한 것처럼 명령을 내릴 수 있습니다.
  3. 터널링: 서버 안에 숨겨진 웹 대시보드를 내 컴퓨터에서 안전하게 열 수 있습니다.

2.4 SSH 키는 왜 필요한가요?

  • 비밀번호 로그인은 해킹 시도에 취약합니다.
  • SSH 키는 “파일 형태의 디지털 열쇠”라서 훨씬 안전합니다.

비유로 이해하기 - 비밀번호 로그인: 문 비밀번호를 숫자로 맞추는 방식 - SSH 키 로그인: 내 손에만 있는 열쇠로 문을 여는 방식

3. 준비물 체크리스트

항목 필수 여부 설명
VPS 서버 필수 Ubuntu 22.04/24.04 추천
터미널 필수 Windows: PowerShell / Mac: Terminal
SSH 키 필수 서버 보안 접속용
OpenClaw 설치 스크립트 필수 공식 경로 사용 권장

4. VPS 보안 세팅

이 파트를 천천히 따라 하면 보안 걱정 없이 OpenClaw를 설치할 수 있습니다.

VPS 보안 세팅 단계를 보여주는 이미지

4.1 SSH 키 만들기 (내 PC에서)

1) 터미널 열기 - Windows: 시작 → PowerShell - Mac: Command + Space → Terminal

2) 키 생성 명령어 입력

ssh-keygen -t ed25519

3) 물음에 답하기 - Enter file in which to save the key: 그냥 엔터 - Enter passphrase: 그냥 엔터 - Enter same passphrase again: 엔터

4) 공개키 확인 Windows PowerShell

cat $env:USERPROFILE\.ssh\id_ed25519.pub

macOS/Linux

cat ~/.ssh/id_ed25519.pub

화면에 ssh-ed25519 AAAA... 로 시작하는 문자열이 보이면 복사해 둡니다.

4.2 VPS에 최초 접속 (root 계정)

ssh root@<VPS_IP>

처음 접속할 때는 이런 메시지가 나옵니다.

Are you sure you want to continue connecting (yes/no)?

여기서 yes 를 입력하세요.

그 다음에는 비밀번호 입력 창이 뜹니다. - 비밀번호를 입력해도 화면에 아무것도 안 보입니다. 정상입니다.

4.3 서버 업데이트와 필수 도구 설치

apt update && apt upgrade -y
apt install -y curl git ufw nano
  • curl : 설치 스크립트 다운로드용
  • git : 소스코드 설치용
  • ufw : 방화벽
  • nano : 텍스트 편집기

4.4 전용 사용자 만들기 (root 대신 사용)

adduser claw
usermod -aG sudo claw
  • claw라는 새로운 사용자를 만듭니다.
  • 앞으로는 root 대신 이 사용자로 작업합니다.

4.5 SSH 키 등록 (가장 중요한 단계)

su - claw
mkdir -p ~/.ssh
chmod 700 ~/.ssh
nano ~/.ssh/authorized_keys
  • 편집 화면이 열리면 아까 복사한 공개키를 붙여넣습니다.
  • 저장: Ctrl + O → Enter
  • 종료: Ctrl + X

그 다음 권한을 잠급니다.

chmod 600 ~/.ssh/authorized_keys

4.6 방화벽 켜기

sudo ufw allow OpenSSH
sudo ufw enable

방화벽을 켜면 SSH만 허용됩니다.

4.7 접속 테스트

이제 내 PC로 돌아가서 새로운 사용자로 접속을 시도합니다.

ssh claw@<VPS_IP>
  • 비밀번호 없이 접속되면 성공입니다.

5. OpenClaw 설치 (공식 권장 방법)

curl -fsSL https://openclaw.bot/install.sh | bash
openclaw onboard --install-daemon

5.1 설치 후 확인

openclaw --version
openclaw doctor
  • doctor는 환경 점검 명령입니다.

6. 대시보드 접속 (SSH 터널링)

OpenClaw 대시보드는 서버 안쪽에서만 열립니다. 따라서 SSH 터널링이 필요합니다.

6.1 터널 열기 (내 PC에서)

ssh -L 18789:127.0.0.1:18789 claw@<VPS_IP>
  • 이 명령을 실행한 터미널은 닫지 마세요.

6.2 대시보드 접속

브라우저 주소창에 입력:

http://127.0.0.1:18789

7. Windows/맥 화면 기준 따라가기

7.1 Windows 10/11 (PowerShell)

  1. 시작 메뉴 → PowerShell 검색 → 실행
  2. 검은 창이 뜨면 명령어를 그대로 붙여넣기
  3. 붙여넣기는 마우스 우클릭
  4. Enter를 누르면 실행됨

자주 보이는 메시지 - Are you sure you want to continue connecting? → yes 입력 - password: → 비밀번호 입력 (화면에 표시되지 않음)

7.2 macOS (Terminal)

  1. Command + Space → Terminal 검색 → 실행
  2. 흰색/검은색 창에 명령어 입력
  3. 붙여넣기는 Command + V

자주 보이는 메시지 - Are you sure you want to continue connecting? → yes 입력 - password: → 비밀번호 입력 (화면에 표시되지 않음)

8. 채널 연결 (Telegram / Discord / Slack)

OpenClaw 채널 연동 흐름 이미지

8.1 Telegram 연결 (가장 쉬운 봇 방식)

1) BotFather에서 봇 생성 - 텔레그램 앱에서 @BotFather 검색 → /newbot 실행 → 토큰 발급

2) OpenClaw에 토큰 등록

openclaw channels add --channel telegram --token <bot-token>

3) 테스트 - 텔레그램에서 봇에게 /start 입력 - 페어링 코드가 오면 승인

8.2 Discord 연결 (봇 계정 방식)

1) 디스코드 개발자 포털에서 봇 생성 - https://discord.com/developers/applications 접속 - New Application → Bot 생성 - Bot Token 복사

2) 봇 초대 링크 생성 - OAuth2 → URL Generator - scopes: bot - bot permissions: Send Messages, Read Message History

3) OpenClaw에 등록

openclaw channels add --channel discord --token <bot-token>

4) 테스트 - 서버 채널에 봇을 초대 후 메시지 전송

8.3 Slack 연결 (워크스페이스 앱 방식)

1) Slack 앱 생성 - https://api.slack.com/apps 접속 → Create New App

2) Bot Token 발급 - OAuth & Permissions → Bot Token Scopes 추가 - chat:write, app_mentions:read 권장 - Install to Workspace → xoxb-... 토큰 복사

3) OpenClaw에 등록

openclaw channels add --channel slack --token <xoxb-token>

4) 테스트 - 채널에서 @봇이름 멘션

9. 유지보수/업데이트

# 업데이트
curl -fsSL https://openclaw.bot/install.sh | bash

# 상태 확인
openclaw status
openclaw gateway status
openclaw logs --follow

10. 마지막 체크리스트

항목 확인
SSH 키 접속 비밀번호 없이 접속되는가?
대시보드 SSH 터널로 접속 가능한가?
봇 연결 텔레그램/디스코드/슬랙에서 대답하는가?
업데이트 최신 버전 유지 가능한가?

함께 읽으면 좋은 글