OpenClaw VPS 호스팅 — 빠른 시작 가이드
대상: OpenClaw VPS 호스팅을 처음 사용하는 고객
💡 요약 정리
- 원스톱 온보딩(권장): 웹 브라우저에서 약 5분만에 완료
- 상세 온보딩: SSH 접속 후 터미널에서 약 10분만에 완료
- 사전 준비물: LLM API Key, 메신저 Bot Token
- 대부분의 과정이 자동으로 진행되므로 초기 설정에만 집중하시면 됩니다.
현재 사용하고 계시는 요금제가 Essential, Basic, Performance, Advanced 이시라면 이전 버전의 가이드를 확인해 주세요: 빠른 시작 가이드(구)
OpenClaw VPS 호스팅은 고객님의 안전한 서비스 운영을 위해 초기 접속을 일부 제한하고 있습니다. 기본 방화벽 설정에 따라, 처음 서비스를 신청하셨던 IP에서만 온보딩 및 대시보드 접속이 가능합니다. 만약 다른 IP에서의 접속이 필요하신 경우, OpenClaw 관리 페이지의 안내에 따라 설정을 추가해 주시기 바랍니다.
목차
1. 전체 흐름 및 사전 준비
1-1. 전체 흐름
OpenClaw VPS 호스팅은 2가지 설정 경로를 제공합니다. 본인에게 맞는 경로를 선택하세요.
| 구분 | 원스톱 온보딩 (권장) | 상세 온보딩 |
|---|---|---|
| 대상 | 서버나 터미널에 익숙하지 않은 분 | SSH, CLI 등 서버 관리에 익숙한 분 |
| 설정 방식 | 웹 브라우저에서 클릭 + 입력 | SSH 접속 후 터미널(TUI)에서 설정 |
| 필요 도구 | 웹 브라우저만 | SSH 클라이언트 (터미널/PuTTY) |
| 소요 시간 | 약 5분 | 약 10분 |
원스톱 온보딩 경로
카페24 신청 → 서버 ON → 나서관에서 "원스톱 온보딩 시작" 클릭 → API Key 입력 → 메신저 연결 → 완료
상세 온보딩 경로
카페24 신청 → 서버 ON → SSH 접속 → openclaw-setup → API Key 입력 → 메신저 연결 → 관리 콘솔 → 완료
1-2. 사전 준비물
어떤 경로를 선택하든 아래 항목을 미리 준비해 주세요.
| 준비물 | 설명 | 필요 경로 |
|---|---|---|
| LLM API Key | Claude, GPT, Gemini 등의 API Key (또는 ChatGPT Plus 계정 — OAuth 인증 가능) | 공통 |
| 메신저 Bot Token | Telegram, Discord, Slack 중 하나의 Bot Token | 공통 |
| SSH 클라이언트 | Mac/Linux 기본 터미널 또는 Windows PuTTY | 상세 온보딩만 |
API Key 발급 방법과 Bot Token 생성 방법은 초기 설정 가이드의 "사전 준비 상세" 섹션에서 안내합니다.
2. 서비스 신청 및 설치 확인
2-1. 카페24 로그인 → 나의 서비스 관리
- 카페24 호스팅 사이트에 로그인합니다.
- 상단 메뉴에서 "나의 서비스 관리"를 클릭합니다.
- 서비스 목록에서 "OpenClaw VPS 호스팅" 항목을 찾습니다.
신청 직후라면 목록에 바로 나타납니다.
2-2. 자동 설치 과정
신청 직후 시스템이 내부적으로 서버를 자동 구성합니다. 이 과정에서 수행되는 작업은 3가지입니다.
| # | 자동 작업 | 설명 |
|---|---|---|
| 1 | OpenClaw 자동 설치 | AI 에이전트 엔진을 서버에 설치 |
| 2 | 온보딩 환경 구성 | 웹 기반 온보딩 위자드 및 대화형 설정 마법사(openclaw-setup) 준비 |
| 3 | 방화벽 룰 설정 | [나의서비스관리 → 방화벽관리] 보안 기본값 적용 |
예상 소요 시간: 약 10~15분
이 단계에서는 기다리기만 하면 됩니다. 별도 작업이 필요하지 않습니다. 설치가 완료되면 서버 상태가 ON으로 표시됩니다.
2-3. OpenClaw 현황 확인 (나의 서비스 관리)
서비스 목록에서 항목을 클릭하면 OpenClaw 관리 페이지로 들어갈 수 있습니다. 좌측 사이드바 메뉴의 기본관리 > OpenClaw 관리에서 현재 서비스 상태를 한눈에 확인할 수 있습니다.
OpenClaw 현황 정보
페이지 상단에 아래 정보가 표시됩니다.
| 항목 | 설명 | 예시 |
|---|---|---|
| 서버 상태 | 현재 서버의 가동 상태. ON이어야 사용 가능 | ● ON |
| OpenClaw 토큰 | 웹 온보딩 및 관리 콘솔 접속에 사용하는 인증 토큰 | oc_tk_a1b2c3d4... |
시작하기
서버 상태가 ON이 되면 "시작하기" 영역에 2개의 버튼이 표시됩니다.
| 버튼 | 설명 | 대상 |
|---|---|---|
| 원스톱 온보딩 시작 | 웹 브라우저에서 바로 설정을 시작합니다 | 서버/터미널에 익숙하지 않은 분 (권장) |
| 상세 온보딩 시작 | 가이드 문서를 확인 후 SSH로 직접 설정합니다 | 서버 관리에 익숙한 분 |
서버 접속 정보 (상세 온보딩용)
상세 온보딩을 선택한 경우 SSH 접속에 필요한 정보도 함께 확인할 수 있습니다.
| 항목 | 예시 |
|---|---|
| IP | 172.233.74.78 |
| 호스트명 | myserver.mycafe24.com |
| 접속 계정 | root |
SSH 접속 명령어를 복사 버튼으로 바로 복사할 수 있습니다.
$ ssh root@myserver.mycafe24.com
좌측 사이드바 메뉴 구조
나의 서비스 관리 페이지의 좌측 메뉴에서 다음 항목들을 이용할 수 있습니다.
| 메뉴 그룹 | 항목 |
|---|---|
| 기본관리 | 서비스 사용현황, OpenClaw 관리 (현재 페이지), 사용량 모니터링, 도메인 연결관리 |
| 연장/변경/추가옵션 | 연장신청, 자동연장설정, 연장견적서 신청, 변경신청 (사양 업그레이드), 초과 트래픽 결제 |
| 서버관리 | 서버관리도우미 신청, 서버관리도우미 진행상황, 방화벽관리, OS재설치 |
2-4. '서버 상태 ON' — 설치 완료
잠시 후 나의 서비스 관리 > OpenClaw 관리 화면을 새로고침하면 상태가 변경됩니다.
서버 상태: ● ON이 상태가 확인되면 설정을 진행할 준비가 된 것입니다.
3. 설정 경로 선택
서버 상태가 ON이 되면, 본인에게 맞는 경로를 선택하여 초기 설정을 진행합니다.
원스톱 온보딩 (권장)
- 서버 경험이 없어도 OK
- 웹 브라우저에서 클릭만으로 완료
- → "원스톱 온보딩 시작" 버튼 클릭
- → 초기 설정 가이드 §1로 이동
상세 온보딩
- SSH, 터미널 사용에 익숙한 분
- 세부 옵션까지 직접 제어
- → 아래 §4 "SSH 접속" 진행
- → 초기 설정 가이드 §2로 이동
어떤 경로를 선택하든 결과는 동일합니다. 두 경로 모두 AI 모델 연결, 메신저 채널 설정, 에이전트 가동까지 완료됩니다. 차이는 설정하는 환경(웹/터미널)뿐입니다.
4. SSH 접속 (상세 온보딩 선택 시)
이 섹션은 "상세 온보딩"을 선택한 분만 진행합니다. 원스톱 온보딩을 선택하셨다면 초기 설정 가이드의 §1로 바로 이동하세요.
4-1. SSH란?
SSH(Secure Shell)는 내 컴퓨터에서 원격 서버에 안전하게 접속하는 방법입니다. 쉽게 말해, 내 PC의 터미널에서 서버 안의 명령을 직접 실행할 수 있게 해줍니다.
4-2. 접속 방법 — Mac / Linux
Mac이나 Linux를 사용하신다면 기본 터미널을 열고 아래 명령어를 입력합니다.
ssh root@{호스트명}.mycafe24.com
예시:
ssh root@myserver.mycafe24.com
- 처음 접속 시
Are you sure you want to continue connecting?이라는 질문이 뜹니다. yes를 입력합니다. - 비밀번호를 입력합니다 (입력 시 화면에 표시되지 않는 것이 정상입니다). 대소문자를 구분하므로 정확히 입력하세요.
4-3. 접속 방법 — Windows
방법 A: Windows Terminal (Windows 10/11)
Windows 10 이상이라면 기본 터미널에서 SSH를 사용할 수 있습니다.
- 시작 메뉴 → Windows Terminal 또는 명령 프롬프트 실행
- 아래 명령어 입력:
ssh root@{호스트명}.mycafe24.com
방법 B: PuTTY
- PuTTY 다운로드에서 설치
- Host Name에
{호스트명}.mycafe24.com입력 - Port는
22(기본값) - Connection type은
SSH선택 - Open 클릭 → 비밀번호 입력
4-4. SSH 키 사용 (선택 사항)
비밀번호 대신 SSH 키로 접속할 수도 있습니다. 보안이 더 강력하며, 비밀번호 입력을 생략할 수 있습니다.
ssh -i ~/.ssh/id_rsa root@{호스트명}.mycafe24.com
SSH 키 생성 방법은 카페24 고객센터의 SSH 키 가이드를 참고해 주세요.
4-5. 접속 성공 확인
접속에 성공하면 터미널 프롬프트가 바뀝니다.
root@openclaw:~#
여기서부터 입력하는 모든 명령은 서버 안에서 실행됩니다.
4-6. 접속이 안 될 때
| 증상 | 확인 사항 |
|---|---|
Connection refused | '나의 서비스 관리'에서 서버 상태가 ON인지 확인 |
Permission denied | 비밀번호가 맞는지 확인 (대소문자 구분) |
Connection timed out | 네트워크 연결 확인. 회사/학교 네트워크에서 SSH 포트(22)가 차단될 수 있음 |
Host key verification failed | ~/.ssh/known_hosts에서 해당 호스트 항목 삭제 후 재접속 |
문제가 지속되면 카페24 고객센터로 문의해 주세요.
다음 단계
선택한 경로에 따라 초기 설정을 진행합니다.
- 원스톱 온보딩을 선택했다면 → 초기 설정 가이드 §1. 원스톱 온보딩
- 상세 온보딩을 선택했다면 → 초기 설정 가이드 §2. 상세 온보딩