본문으로 건너뛰기

OpenClaw VPS 호스팅 — 운영 가이드

운영 중 설정 변경, 서비스 재시작, 로그 확인, 자주 묻는 질문과 문제 해결 방법을 안내합니다.

💡 요약 정리

  • 설정은 대시보드(Config → Raw) 또는 연동된 채널에서 텔레그램에 직접 요청해 가능합니다
    • openclaw 에이전트에게 요청 권장 (설정 파일 위치: 컨테이너 내부 /data/.openclaw/openclaw.json)
  • 설정 변경 후에는 su - openclaw -c "podman restart openclaw-svc"로 Gateway를 재시작해야 합니다. (대시보드에서 Save한 경우 자동 reload되어 재시작 불필요)
  • 실시간 로그는 su - openclaw -c "podman logs -f openclaw-svc"로 확인합니다.
  • 서버 요금 외에 LLM API 비용이 별도로 발생합니다.
  • 문제 발생 시 로그를 먼저 확인하고, 해결되지 않으면 카페24 고객센터로 문의해 주세요.

목차

  1. 설정 변경
  2. 로그 확인
  3. 서비스 관리 명령어
  4. FAQ — 자주 묻는 질문
  5. 트러블슈팅 — 문제 해결

1. 설정 변경

1-1. 설정 파일 위치와 구조

OpenClaw의 설정은 컨테이너 내부 JSON 파일에 저장되어 있습니다:

컨테이너 내부: /data/.openclaw/openclaw.json

⚠️ 이 파일은 컨테이너 안에 있으므로 직접 vim/nano로 편집하지 않습니다. 대시보드 또는 openclaw-setup을 사용하세요.

주요 설정 항목 (JSON 구조)

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/gpt-4o"
      }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "1234567890:AAHxxxxxxxxxxxxx"
    }
  },
  "gateway": {
    "port": 60000,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "your-gateway-token"
    }
  }
}

1-2. 설정 변경 방법

방법 A: 대시보드에서 변경 (권장)

  1. SSH 터널로 대시보드 접속
  2. Config → Raw 모드에서 JSON 직접 편집
  3. Save 클릭 → Gateway가 자동 reload (재시작 불필요)

방법 B: openclaw-setup 재실행

openclaw-setup

onboard TUI에서 LLM 모델, 메신저 등을 다시 설정할 수 있습니다.

2. 로그 확인

2-1. 실시간 로그 보기

su - openclaw -c "podman logs -f openclaw-svc"

새 로그가 생길 때마다 실시간으로 출력합니다. 종료하려면 Ctrl+C를 누릅니다.

2-2. 최근 로그 보기 (최근 100줄)

su - openclaw -c "podman logs --tail 100 openclaw-svc"

2-3. 특정 시간 이후 로그 보기

su - openclaw -c "podman logs --since 2026-02-12T00:00:00 openclaw-svc"

※ 로그 시간은 UTC 기준입니다. 한국 시간(KST)은 UTC + 9시간입니다. 예) 로그에 01:00 UTC = 한국 시간 10:00 KST 한국 시간 오후 2시 이후 로그를 보려면 --since에 05:00 입력

2-4. 흔한 로그 메시지 해석

로그 메시지의미조치
API key expiredAPI Key 만료제공사 사이트에서 새 키 발급 후 openclaw-setup 재실행
Rate limit exceededAPI 호출 한도 초과잠시 대기 또는 요금제 업그레이드
Insufficient creditsAPI 잔액 부족제공사 사이트에서 크레딧 충전
Bot token invalid메신저 토큰 오류토큰 재발급 후 대시보드 Config에서 수정
Permission denied봇 권한 부족메신저에서 봇 권한 재설정
Connection timeout네트워크 문제방화벽 설정 확인, 인터넷 연결 확인

3. 서비스 관리 명령어

3-1. 명령어 모음 (root에서 실행)

명령어용도
su - openclaw -c "podman ps"현재 상태 확인
su - openclaw -c "podman restart openclaw-svc"재시작 (설정 변경 후)
su - openclaw -c "podman stop openclaw-svc"서비스 중지
su - openclaw -c "podman start openclaw-svc"서비스 시작
su - openclaw -c "podman logs -f openclaw-svc"실시간 로그
su - openclaw -c "podman logs --tail 100 openclaw-svc"최근 로그 100줄
openclaw-setup설정 재실행 (TUI)

3-2. 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줄

3-3. 일상 운영 체크리스트

정기적으로 확인하면 좋은 항목입니다:

  • 서비스 상태: su - openclaw -c "podman ps" — Up 상태 확인
  • 최근 로그: su - openclaw -c "podman logs --tail 20 openclaw-svc" — 오류 없는지 확인
  • API 잔액: LLM 제공사 대시보드에서 크레딧 잔액 확인
  • 관리 콘솔: 대화 히스토리에서 비정상 패턴 확인

팁: 문제가 없다면 평소에는 메신저 사용하는 것만으로 충분합니다. 서버에 매일 접속할 필요는 없습니다.

4. FAQ — 자주 묻는 질문

Q1. 설치는 얼마나 걸리나요?

신청 후 약 3~5분이면 설치가 완료됩니다. '나의 서비스 관리'에서 상태가 **'서버 상태 ON'**으로 표시되면 완료입니다.

Q2. 어떤 AI 모델을 지원하나요?

모델제공사비고
Claude (Sonnet / Opus)Anthropic한국어 성능 우수
GPT-4o / GPT-4OpenAI가장 범용적
Gemini Pro / UltraGoogleGoogle 생태계 연동

Q3. 여러 메신저를 동시에 연결할 수 있나요?

기본 설정에서는 하나의 메신저에 연결됩니다. 여러 메신저를 동시에 사용하려면 config.yaml에서 추가 설정이 필요합니다. 자세한 내용은 OpenClaw 공식 문서를 참고해 주세요.

Q4. 서버 요금 외에 추가 비용이 있나요?

네, LLM API 비용이 별도로 발생합니다.

항목비용청구처
서버 호스팅 (OpenClaw VPS 호스팅)월 66,000원~ (사양별)카페24
LLM API 사용료사용량에 따라 (월 $5~$100+)Anthropic / OpenAI / Google

API 비용은 AI 모델에 보내는 메시지 양에 비례합니다. 적게 쓰면 적게 나오고, 많이 쓰면 많이 나옵니다.

비용 관리 팁:

  • LLM 제공사 대시보드에서 사용량 알림을 설정하세요.
  • 불필요한 대화 기록 전체 전송을 피하면 비용을 줄일 수 있습니다.

Q5. 보안은 안전한가요?

OpenClaw VPS 호스팅은 다층 보안 구조로 보호됩니다:

레이어기술역할
1차Firewall네트워크 레벨 필터링 (SSH만 허용) / 나의서비스관리 - 방화벽관리
2차AppArmor경로 기반 강제 접근 제어
3차Podman Rootless데몬 없는 컨테이너, root 권한 불필요
4차User Namespace컨테이너 UID를 호스트 일반 사용자로 매핑
5차All-in-One Container리소스 제한, 위험 명령 차단
6차fail2banSSH 브루트포스 방어

컨테이너를 탈출하더라도 일반 사용자 권한만 획득할 수 있어 서버 전체가 탈취되는 것을 방지합니다.

Q6. 서버 사양을 나중에 올릴 수 있나요?

네, 서비스 중에 상위 사양으로 즉시 업그레이드 가능합니다. '나의 서비스 관리'에서 스케일업 신청을 하면 됩니다.

현재 → 변경가격 변동
EASY B → EASY C66,000원 → 132,000원/월
EASY C → EASY D132,000원 → 220,000원/월

Q7. 관리 콘솔을 외부에서 직접 접속할 수 있나요?

보안을 위해 SSH 터널을 통해서만 접속할 수 있도록 설계되어 있습니다. 관리 콘솔을 외부에 직접 노출하면 인증 우회 공격에 취약해질 수 있으므로 권장하지 않습니다.

접속 방법:

# Linux/macOS
ssh -N -L 50000:127.0.0.1:50000 root@{서버IP}

# 브라우저에서 접속
http://localhost:50000/#token=<GATEWAY_TOKEN>

Windows(PuTTY)는 초기 설정 가이드의 SSH 터널 설정 부분을 참고하세요.

5. 트러블슈팅 — 문제 해결

문제 1: SSH 접속이 안 됩니다

ssh: connect to host {서버IP} port 22: Connection refused

체크리스트:

  1. '나의 서비스 관리'에서 서버 상태가 ON인지 확인
  2. 서버 IP가 정확한지 확인 ('서비스 상세' 화면 참고)
  3. 비밀번호가 맞는지 확인 (대소문자 구분)
  4. 회사/학교 네트워크에서 SSH 포트(22)가 차단되어 있을 수 있음 → 다른 네트워크에서 시도

문제 2: openclaw-setup 연결 테스트 실패

LLM 연결 실패 시:

  • API Key가 정확한지 확인 (앞뒤 공백 없이 붙여넣기)
  • API 크레딧이 남아 있는지 확인
  • 제공사 사이트에서 Key가 활성 상태인지 확인

메신저 연결 실패 시:

  • Bot Token이 정확한지 확인
  • Slack: 봇에 필요한 권한(scope)이 모두 부여되었는지 확인
  • Discord: MESSAGE CONTENT INTENT가 활성화되었는지 확인
  • Telegram: @BotFather에서 발급받은 Token이 맞는지 확인

문제 3: 관리 콘솔에 접속이 안 됩니다

체크리스트:

  1. SSH 터널 창이 열려 있는지 확인 (닫으면 접속 끊김)
  2. 터널 명령어가 맞는지 확인: ssh -N -L 50000:127.0.0.1:50000 root@{서버IP}
  3. 브라우저 주소가 http://localhost:50000/#token=<GATEWAY_TOKEN>인지 확인 (https가 아닌 http)
  4. 컨테이너가 실행 중인지 확인: su - openclaw -c "podman ps"

문제 4: 봇이 메신저에서 응답하지 않습니다

체크리스트:

  1. 컨테이너가 실행 중인지 확인: su - openclaw -c "podman ps"
  2. 실행 중이 아니라면 시작: su - openclaw -c "podman start openclaw-svc"
  3. 로그에서 오류 확인: su - openclaw -c "podman logs --tail 50 openclaw-svc"
  4. 흔한 원인:
    • API Key 만료 → openclaw-setup 재실행
    • API 잔액 부족 → 크레딧 충전
    • 메신저 토큰 만료 → openclaw-setup 재실행하여 토큰 재입력
    • 텔레그램 polling 미동작 → 알려진 Node 22 버그로 미작동 할 수 있음 ㄴ 반드시 봇 연동시 새로운 봇 생성하여 연동을 권장, 해결되지 않을시 OS재설치 하여 이용 권장

문제 5: 서비스가 자꾸 죽습니다 (멈춤)

원인확인 방법해결
메모리 부족 (OOM)su - openclaw -c "podman logs --tail 50 openclaw-svc"에서 OOM 확인사양 업그레이드 (EASY B → EASY C)
디스크 부족df -h로 디스크 사용량 확인불필요 파일 정리 또는 사양 업그레이드
설정 오류로그에서 config error 확인openclaw-setup 재실행

재시작 명령어:

su - openclaw -c "podman restart openclaw-svc"

지원 채널

문제가 해결되지 않는다면 아래 채널로 문의해 주세요:

채널연락처
카페24 고객센터 (전화)1588-3284
카페24 고객센터 (온라인)hosting.cafe24.com 내 1:1 문의
운영 시간평일 09:00 ~ 18:00 (공휴일 제외)

한 줄 요약: "나의 서비스 관리에서 '서버 상태 ON'만 확인하고, SSH로 openclaw-setup 한 번 실행하면, 이후부터는 메신저 또는 대시보드에서 대화하는 것이 사용 방식입니다."