OpenClaw VPS 호스팅 — 운영 가이드
💡 요약 정리
- 설정 변경은 온보딩 홈 화면, OpenClaw 대시보드, SSH 직접 변경 3가지 방법이 있습니다.
- 설정 변경 후에는
podman restart openclaw-svc로 컨테이너를 재시작해야 합니다. - 실시간 로그는
podman logs -f openclaw-svc로 확인합니다. - 서버 요금 외에 LLM API 비용이 별도로 발생합니다.
- 문제 발생 시 로그를 먼저 확인하고, 해결되지 않으면 카페24 고객센터로 문의해 주세요.
현재 사용하고 계시는 요금제가 Essential, Basic, Performance, Advanced 이시라면 이전 버전의 가이드를 확인해 주세요: 운영 가 이드(구)
OpenClaw VPS 호스팅은 고객님의 안전한 서비스 운영을 위해 초기 접속을 일부 제한하고 있습니다. 기본 방화벽 설정에 따라, 처음 서비스를 신청하셨던 IP에서만 온보딩 및 대시보드 접속이 가능합니다. 만약 다른 IP에서의 접속이 필요하신 경우, OpenClaw 관리 페이지의 안내에 따라 설정을 추가해 주시기 바랍니다.
운영 중 설정 변경, 서비스 재시작, 로그 확인, 자주 묻는 질문과 문제 해결 방법을 안내합니다.
1. 설정 변경
OpenClaw의 설정을 변경하는 방법은 3가지입니다.
| 방법 | 대상 | 특징 |
|---|---|---|
| 온보딩 홈 화면 | 원스톱 온보딩 사용자 | Gateway 재시작, 전체 초기화 등 기본 운영 기능 |
| OpenClaw 대시보드 | 모든 사용자 (권장) | AI 모델, 메신저, 페르소나 등 상세 설정 변경 |
| SSH 직접 변경 | 상세 온보딩 사용자 | 파일 편집 + 명령어로 직접 제어 |
1-1. 온보딩 홈 화면에서 변경
원스톱 온보딩을 완료한 후, 온보딩 화면의 홈 화면에서 다음 기본 운영 기능을 실행할 수 있습니다.
| 기능 | 설명 |
|---|---|
| Gateway 재시작 / OpenClaw 업데이트 | - 메신저 연결 문제 시 Gateway를 재시작합니다 - 새로운 버전의 OpenClaw로 업데이트합니다 |
| 전체 초기화 | 모든 설정을 삭제하고 온보딩을 처음부터 다시 시작합니다 |
참고: AI 모델 변경, 메신저 추가/삭제, 페르소나 설정 등 기타 상세 설정 변경은 OpenClaw 대시보드에서 진행할 수 있습니다.
1-2. SSH에서 직접 변경
SSH로 서버에 접속하여 설정 파일을 직접 편집하는 방식입니다.
주요 설정 파일
| 파일 | 위치 (컨테이너 내부) | 역할 |
|---|---|---|
| openclaw.json | /data/openclaw.json | Gateway 설정 (모델, 채널, 플러그인, 인증 토큰) |
| auth-profiles.json | /data/auth-profiles.json | AI 프로바이더 인증 정보 (API Key, OAuth 토큰) |
| SOUL.md | /data/SOUL.md | AI 에이전트 페르소나 (시스템 프롬 프트) |
| .env | /opt/openclaw/.env | 환경 변수 (포트, 토큰, API Key) |
설정 변경 절차
- openclaw 사용자로 전환:
su - openclaw
- 컨테이너 내부 접속:
podman exec -it -u node openclaw-svc bash
- 설정 파일 편집:
vi /data/openclaw.json
- 컨테이너 재시작: (exit로 컨테이너에서 나온 후)
podman restart openclaw-svc
자주 하는 설정 변경
| 변경 사항 | 파일 | 방법 |
|---|---|---|
| LLM 모델 변경 | openclaw.json | agents.main.model 값 수정 |
| API Key 교체 | .env | 해당 프로바이더 KEY 값 수정 후 podman restart openclaw-svc |
| 메신저 추가/변경 | openclaw.json | channels 섹션 수정 |
| 페르소나 변경 | SOUL.md | 직접 편집 |
참고: .env 파일은 컨테이너 외부(
/opt/openclaw/.env)에 있어, 컨테이너 재빌드 없이 수정 후podman restart openclaw-svc만으로 반영됩니다.
2. 로그 확인
2-1. 실시간 로그 보기
openclaw 사용자로 전환 후 실행합니다:
su - openclaw
podman logs -f openclaw-svc
-f 옵션은 새 로그가 생길 때마다 실시간으로 출력합니다. 종료하려면 Ctrl+C를 누릅니다.
2-2. 최근 로그 보기 (최근 100줄)
podman logs --tail 100 openclaw-svc
2-3. 흔한 로그 메시지 해석
| 로그 메시지 | 의미 | 조치 |
|---|---|---|
API key expired | API Key 만료 | 제공사 사이트에서 새 키 발급 후 OpenClaw 대시보드 또는 .env에서 수정 |
Rate limit exceeded | API 호출 한도 초과 | 잠시 대기 또는 요금제 업그레이드 |
Insufficient credits | API 잔액 부족 | 제공사 사이트에서 크레딧 충전 |
Bot token invalid | 메신저 토큰 오류 | 토큰 재발급 후 OpenClaw 대시보드 또는 SSH에서 직접 변경 |
Permission denied | 봇 권한 부족 | 메신저에서 봇 권한 재설정 |
Connection timeout | 네트워크 문제 | 방화벽 설정 확인, 인터넷 연결 확인 |
Gateway cooldown | Gateway 재시작 제한 (10초) | 10초 후 재시도 |
3. 서비스 관리 명령어
3-1. 명령어 모음
아래 명령어는 openclaw 사용자로 전환 후 실행합니다: su - openclaw
| 명령어 | 용도 |
|---|---|
podman ps | 컨테이너 상태 확인 |
podman restart openclaw-svc | 컨테이너 재시작 (설정 변경 후) |
podman stop openclaw-svc | 서비스 중지 |
podman start openclaw-svc | 서비스 시작 |
podman logs -f openclaw-svc | 실시간 로그 |
podman logs --tail 100 openclaw-svc | 최근 로그 100줄 |
root 사용자에서 실행하는 명령어:
| 명령어 | 용도 |
|---|---|
openclaw-setup | 설정 마법사 재실행 (초기화 겸 재구성) |
3-2. 일상 운영 체크리스트
정기적으로 확인하면 좋은 항목입니다:
- 서비스 상태:
podman ps—Up상태 확인 (openclaw 사용자에서) - 최근 로그:
podman logs --tail 20 openclaw-svc— 오류 없는지 확인 - API 잔액: LLM 제공사 대시보드에서 크레딧 잔액 확인
- OpenClaw 대시보드: 대화 히스토리에서 비정상 패턴 확인
팁: 문제가 없다면 평소에는 메신저에서 봇을 사용하는 것만으로 충분합니다. 서버에 매일 접속할 필요는 없습니다.
4. FAQ — 자주 묻는 질문
Q1. 설치는 얼마나 걸리나요?
신청 후 약 10~15분이면 설치가 완료됩니다. '나의 서비스 관리'에서 상태가 서버 상태 ON으로 표시되면 완료입니다.
Q2. 원스톱 온보딩과 상세 온보딩의 차이는?
| 항목 | 원 스톱 온보딩 | 상세 온보딩 |
|---|---|---|
| 설정 환경 | 웹 브라우저 | SSH 터미널 (TUI) |
| 필요 지식 | 없음 | SSH, CLI 기본 사용법 |
| 세부 옵션 | 핵심 설정만 | Skills, Hooks, 웹 검색 등 고급 설정 가능 |
| 결과 | 동일 — AI 모델 연결 + 메신저 봇 가동 |
어떤 경로를 선택하든 최종 결과는 같습니다. 나중에 상세 설정이 필요하면 SSH로 추가 설정할 수 있습니다.
Q3. 어떤 AI 모델을 지원하나요?
| 구분 | 모델 | 제공사 | 비고 |
|---|---|---|---|
| 주요 | Claude (Sonnet / Opus) | Anthropic | 코딩 기능 우수 |
| GPT-4o / GPT-5 | OpenAI | OAuth 지원 | |
| Gemini Pro / Ultra | Google 생태계 연동 | ||
| 기타 | Kimi (k2.5, moonshot-v1) | Moonshot | 중국 AI 서비스 |
| MiniMax-M2.5 등 | MiniMax | 중국 AI 서비스 | |
| GLM-5, GLM-4.7 등 | Z.AI | 중국 AI 서비스 |
Q4. 여러 메신저를 동시에 연결할 수 있나요?
네, 가능합니다. OpenClaw 대시보드의 설정 > 메신저에서 여러 채널을 추가하거나, SSH 접속 후 openclaw.json의 channels 섹션에서 직접 변경할 수 있습니다.
Q5. 서버 요금 외에 추가 비용이 있나요?
네, LLM API 비용이 별도로 발생합니다.| 항목 | 비용 | 청구처 |
|---|---|---|
| 서버 호스팅 (OpenClaw VPS) | 월 14,000원~ (사양별) | 카페24 |
| LLM API 사용료 | 사용량에 따라 (월 $5~$100+) | Anthropic / OpenAI / Google 등 |
API 비용은 AI 모델에 보내는 메시지 양에 비례합니다.
비용 관리 팁:
- LLM 제공사 대시보드에서 사용량 알림을 설정하세요.
- 불필요한 대화 기록 전체 전송을 피하면 비용을 줄일 수 있습니다.
Q6. 보안은 안전한가요?
OpenClaw VPS 호스팅은 Podman 보안 레이어로 보호됩니다:
| 레이어 | 기술 | 역할 |
|---|---|---|
| 호스트 | fail2ban | SSH bruteforce 차단 (5회 실패 시 10분 차단) |
| 호스트 | 바이너리 보호 (chmod 700) | curl, wget, nc 등 실행 제한 |
| 호스트 | AppArmor | 경로 기반 강제 접근 제어 |
| 컨테이너 | Podman Rootless | 비root 컨테이너 실행, subuid/subgid 매핑 |
| 컨테이너 | safe-rm + block-commands | 위험 명령어(mkfs, fdisk, shutdown 등) 차단 |
| 인증 | 토큰 인증 | 웹 접근 시 OPENCLAW_GATEWAY_TOKEN 필수 |
Docker 기반 실행과 달리, 만약 컨테이너를 탈출하더라도 일반 사용자 권한만 획득할 수 있어 서버 전체가 탈취되는 것을 방지합니다.
Q7. 서버 사양을 나중에 올릴 수 있나요?
네, 서비스 중에 상위 사양으로 즉시 업그레이드 가능합니다. '나의 서비스 관리 > 변경신청'에서 차액만 결제하면 됩니다.
| 현재 → 변경 | 가격 변동 |
|---|---|
| Lite → Core | 14,000원 → 33,000원/월 |
| Core → Pro | 33,000원 → 55,000원/월 |
데이터 마이그레이션이나 재설정 없이 그대로 사용할 수 있습니다.
Q8. OpenClaw 대시보드를 외부에서 직접 접속할 수 있나요?
원스톱 온보딩 사용자: 나의 서비스 관리에서 제공되는 접속 경로로 이용할 수 있습니다.
상세 온보딩 사용자: TUI를 통한 설정 완료 이후 제공되는 접속 경로로 이용할 수 있습니다.
5. 트러블슈팅 — 문제 해결
문제 1: SSH 접속이 안 됩니다
ssh: connect to host myserver.mycafe24.com port 22: Connection refused
체크리스트:
- '나의 서비스 관리'에서 서버 상태가 ON인지 확인
- 호스트명이 정확한지 확인 ('OpenClaw 관리' 화면 참고)
- 비밀번호가 맞는지 확인 (대소문자 구분)
- 회사/학교 네트워크에서 SSH 포트(22)가 차단되어 있을 수 있음 → 다른 네트워크에서 시도
문제 2: 원스톱 온보딩 로그인이 안 됩니다
체크리스트:
- 나의 서비스 관리 > OpenClaw 관리에서 표시된 OpenClaw 토큰을 정확히 입력했는지 확인 (앞뒤 공백 없이)
- 서버 상태가 ON인지 확인
- 브라우저 캐시를 삭제하고 다시 시도
- 다른 브라우저에서 시도
문제 3: API Key 검증에 실패합니다
체크리스트:
- API Key가 정확한지 확인 (앞뒤 공백 없이 붙여넣기)
- API 크레딧이 남아 있는지 확인
- 제공사 사이트에서 Key가 활성 상태인지 확인
문제 4: OAuth 인증이 완료되지 않습니다
원스톱 온보딩:
- 팝업 차단이 활성화되어 있으면 OpenAI 로그인 페이지가 열리지 않을 수 있습니다. 팝업 허용 후 재시도하세요.
- 로그인 후 자동으로 돌아오지 않으면 브라우저 주소창의 URL을 확인하세요.
상세 온보딩 (SSH):
- OAuth URL을 내 PC의 브라우저에서 열어야 합니다. (서버 터미널이 아님)
- 콜백 URL이 에러 페이지를 보여주는 것은 정상입니다. 주소창의 전체 URL을 복사하여 터미널에 붙여넣으세요.
문제 5: 메신저 봇이 응답하지 않습니다
체크리스트:
- 컨테이너가 실행 중인지 확인:
su - openclaw→podman ps - 실 행 중이 아니라면:
podman start openclaw-svc - 로그에서 오류 확인:
podman logs --tail 50 openclaw-svc - 흔한 원인:
- API Key 만료 → 새 키 발급 후 OpenClaw 대시보드 또는 .env에서 수정 → 재시작
- API 잔액 부족 → 크레딧 충전
- 메신저 토큰 만료 → 토큰 재발급 후 OpenClaw 대시보드 또는 SSH에서 직접 변경 → 재시작
- 페어링 미승인 → 봇에
/start입력 후 Pairing 코드 승인
문제 6: Gateway가 시작되지 않습니다
체크리스트:
- Gateway 재시작은 최소 10초 간격으로만 가능합니다. 잠시 기다린 후 다시 시도하세요.
- openclaw.json에
tools.profile = "full"설정이 있는지 확인하세요. 이 설정이 빠지면 일부 기능이 제한됩니다. - 로그 확인:
podman logs --tail 50 openclaw-svc
문제 7: 서비스가 자꾸 죽습니다 (멈춤)
| 원인 | 확인 방법 | 해결 |
|---|---|---|
| 메모리 부족 (OOM) | podman logs openclaw-svc에서 OOM 메시지 | 사양 업그레이드 (Lite → Core 등) |
| 디스크 부족 | df -h로 디스크 사용량 확인 | 불필요 파일 정리 또는 사양 업그레이드 |
| 설정 오류 | 로그에서 config error 확인 | openclaw-setup으로 재설정 (root에서 실행) |
재시작 명령어 (openclaw 사용자에서):
podman restart openclaw-svc
문제 8: 텔레그램 봇 토큰 변경 후 동작하지 않습니다
토큰을 변경한 경우, 컨테이너 내부의 update-offset-default.json 파일을 삭제해야 합니다:
su - openclaw
podman exec -u node openclaw-svc rm -f /data/update-offset-default.json
podman restart openclaw-svc
지원 채널
문제가 해결되지 않는다면 아래 채널로 문의해 주세요:
| 채널 | 연락처 |
|---|---|
| 카페24 고객센터 (전화) | 1588-3284 |
| 카페24 고객센터 (온라인) | help.cafe24.com 내 1:1 문의 |
| 운영 시간 | 평일 09:00 ~ 18:00 (공휴일 제외) |
문제가 해결되지 않았나요?
위 트러블슈팅으로 해결되지 않는 경우, 아래 정보를 준비하여 카페24 고객센터로 문의해 주세요.
- 카페24 아이디
- 서버 호스트명 (예: myserver.mycafe24.com)
- 문제 현상 설명 및 로그 메시지 (
podman logs --tail 50 openclaw-svc결과)
한 줄 요약: "나의 서비스 관리에서 '서버 상태 ON'만 확인하고, 원스톱 온보딩 또는 openclaw-setup으로 설정을 완료하면, 이후부터는 메신저에서 대화하는 것이 사용 방식입니다."