OpenClaw VPS 호스팅 — 운영 가이드(구)
운영 중 설정 변경, 서비스 재시작, 로그 확인, 자주 묻는 질문과 문제 해결 방법을 안내합니다.
💡 요약 정리
- 설정 파일 위치:
~/.openclaw/config.yaml - 설정 변경 후에는
systemctl restart openclaw로 서비스를 재시작해야 합니다. - 실시간 로그는
journalctl -u openclaw -f로 확인합니다. - 서버 요금 외에 LLM API 비용이 별도로 발생합니다.
- 문제 발생 시 로그를 먼저 확인하고, 해결되지 않으면 카페24 고객센터로 문의해 주세요.
목차
- 설정 변경
- 로그 확인
- 서비스 관리 명령어
- FAQ — 자주 묻는 질문
- 트러블슈팅 — 문제 해결
1. 설정 변경
1-1. 설정 파일 위치와 구조
OpenClaw의 모든 설정은 하나의 파일에 저장되어 있습니다:
~/.openclaw/config.yaml
주요 설정 항목
# LLM 설정
llm:
provider: claude # claude / openai / gemini
api_key: sk-ant-api03-... # API Key
model: claude-sonnet-4-5-20250929 # 사용 모델
# 메신저 설정
messenger:
platform: slack # slack / discord / telegram
token: xoxb-... # Bot Token
# 에이전트 설정
agent:
language: ko # 응답 언어
max_tokens: 4096 # 최대 응답 길이
1-2. 설정 변경 방법
1단계: 설정 파일 편집
SSH로 서버에 접속한 뒤 설정 파일을 엽니다:
vim ~/.openclaw/config.yaml
vim이 익숙하지 않다면 nano를 사용할 수도 있습니다:
nano ~/.openclaw/config.yaml
2단계: 수정 후 저장
- vim:
ESC→:wq→Enter - nano:
Ctrl+O→Enter→Ctrl+X
3단계: 서비스 재시작
설정을 변경한 후에는 서비스를 재시작해야 적용됩니다:
systemctl restart openclaw
4단계: 상태 확인
재시작이 정상적으로 되었는지 확인합니다:
systemctl status openclaw
active (running)이 표시되면 정상입니다.
1-3. 자주 하는 설정 변경
| 변경 사항 | 수정 위치 | 예시 |
|---|---|---|
| LLM 모델 변경 | llm.model | claude-sonnet-4-5-20250929 → gpt-4o |
| API Key 교체 | llm.api_key | 새 키로 교체 |
| 메신저 변경 | messenger.platform + messenger.token | Slack → Discord |
| 응답 언어 변경 | agent.language | ko → en |
| 응답 길이 조절 | agent.max_tokens | 4096 → 8192 |
팁: 설정 변경 후에는 항상 systemctl restart openclaw를 실행해 주세요.
2. 로그 확인
2-1. 실시간 로그 보기
서버에서 실시간으로 로그를 확인하려면:
journalctl -u openclaw -f
-f 옵션은 새 로그가 생길 때마다 실시간으로 출력합니다. 종료하려면 Ctrl+C를 누릅니다.
2-2. 최근 로그 보기 (최근 100줄)
journalctl -u openclaw -n 100
2-3. 오늘 로그만 보기
journalctl -u openclaw --since today
2-4. 흔한 로그 메시지 해석
| 로그 메시지 | 의미 | 조치 |
|---|---|---|
API key expired | API Key 만료 | 제공사 사이트에서 새 키 발급 후 config.yaml 수정 |
Rate limit exceeded | API 호출 한도 초과 | 잠시 대기 또는 요금제 업그레이드 |
Insufficient credits | API 잔액 부족 | 제공사 사이트에서 크레딧 충전 |
Bot token invalid | 메신저 토큰 오류 | 토큰 재발급 후 config.yaml 수정 |
Permission denied | 봇 권한 부족 | 메신저에서 봇 권한 재설정 |
Connection timeout | 네트워크 문제 | 방화벽 설정 확인, 인터넷 연결 확인 |
3. 서비스 관리 명령어
3-1. 명령어 모음
| 명령어 | 용도 |
|---|---|
systemctl status openclaw | 현재 상태 확인 |
systemctl restart openclaw | 재시작 (설정 변경 후) |
systemctl stop openclaw | 서비스 중지 |
systemctl start openclaw | 서비스 시작 |
journalctl -u openclaw -f | 실시간 로그 |
journalctl -u openclaw -n 100 | 최근 로그 100줄 |
3-2. 일상 운영 체크리스트
정기적으로 확인하면 좋은 항목입니다:
- 서비스 상태:
systemctl status openclaw—active (running)확인 - 최근 로그:
journalctl -u openclaw -n 20— 오류 없는지 확인 - API 잔액: LLM 제공사 대시보드에서 크레딧 잔액 확인
- 관리 콘솔: 대화 히스토리에서 비정상 패턴 확인
팁: 문제가 없다면 평소에는 메신저에서 봇을 사용하는 것만으로 충분합니다. 서버에 매일 접속할 필요는 없습니다.
4. FAQ — 자주 묻는 질문
Q1. 설치는 얼마나 걸리나요?
신청 후 약 3~5분이면 설치가 완료됩니다. '나의 서비스 관리'에서 상태가 '서버 상태 ON'으로 표시되면 완료입니다.
Q2. 어떤 AI 모델을 지원하나요?
openclaw와 연동이 가능한 모든 AI모델을 지원합니다.
openclaw setup에서 선택하거나, ~/.openclaw/config.yaml에서 변경할 수 있습니다.
Q3. 여러 메신저를 동시에 연결할 수 있나요?
기본 설정에서는 하나의 메신저에 연결됩니다. 여러 메신저를 동시에 사용하려면 config.yaml에서 추가 설정이 필요합니다. 자세한 내용은 OpenClaw 공식 문서를 참고해 주세요.
Q4. 서버 요금 외에 추가 비용이 있 나요?
네, LLM API 비용이 별도로 발생합니다.
| 항목 | 비용 | 청구처 |
|---|---|---|
| 서버 호스팅 (OpenClaw VPS 호스팅) | 월 66,000원~ (사양별) | 카페24 |
| LLM API 사용료 | 사용량에 따라 (월 $5~$100+) | Anthropic / OpenAI / Google |
API 비용은 AI 모델에 보내는 메시지 양에 비례합니다. 적게 쓰면 적게 나오고, 많이 쓰면 많이 나옵니다.
비용 관리 팁:
- LLM 제공사 대시보드에서 사용량 알림을 설정하세요.
- 불필요한 대화 기록 전체 전송을 피하면 비용을 줄일 수 있습니다.
- OpenClaw VPS 호스팅는 API 비용 최적화 설정이 기본 적용되어 있습니다.
Q5. 보안은 안전한가요?
OpenClaw VPS 호스팅는 Podman 보안 레이어로 보호됩니다:
| 레이어 | 기술 | 역할 |
|---|---|---|
| 1차 | Linode Cloud Firewall | 네트워크 레벨 필터링 (SSH만 허용) |
| 2차 | SELinux (Enforcing) | 강제 접근 제어 |
| 3차 | Podman Rootless | 데몬 없는 컨테이너, root 권한 불필요 |
| 4차 | User Namespace | 컨테이너 UID를 호스트 일반 사용자로 매핑 |
| 5차 | Sandbox Container | 일회성 격리 환경, 작업 후 자동 파기 |
Docker 기반 실행과 달리, 만약 컨테이너를 탈출하더라도 일반 사용자 권한만 획득할 수 있어 서버 전체가 탈취되는 것을 방지합니다.
Q6. 서버 사양을 나중에 올릴 수 있나요?
네, 서비스 중에 상위 사양으로 즉시 업그레이드 가능합니다. '나의 서비스 관리'에서 변경 신청을 하면 됩니다.
Q7. 관리 콘솔을 외부에서 직접 접속할 수 있나요?
보안을 위해 SSH 터널을 통해서만 접속할 수 있도록 설계되어 있습니다. 관리 콘솔을 외부에 직접 노출하면 인증 우회 공격에 취약해질 수 있으므로 권장하지 않습니다.
5. 트러블슈팅 — 문제 해결
문제 1: SSH 접속이 안 됩니다
ssh: connect to host myserver.cafe24.com port 22: Connection refused
체크리스트:
- '나의 서비스 관리'에서 서버 상태가 ON인지 확인
- 호스트명이 정확한지 확인 ('서비스 상세' 화면 참고)
- 비밀번호가 맞는지 확인 (대소문자 구분)
- 회사/학교 네트워크에서 SSH 포트(22)가 차단되어 있을 수 있음 → 다른 네트워크에서 시도
문제 2: openclaw setup 연결 테스트 실패
LLM 연결 실패 시:
- API Key가 정확한지 확인 (앞뒤 공백 없이 붙여넣기)
- API 크레딧이 남아 있는지 확인
- 제공사 사이트에서 Key가 활성 상태인지 확인
메신저 연결 실패 시:
- Bot Token이 정확한지 확인
- Slack: 봇에 필요한 권한(scope)이 모두 부여되었는지 확인
- Discord: MESSAGE CONTENT INTENT가 활성화되었는지 확인
- Telegram: @BotFather에서 발급받은 Token이 맞는지 확인
문제 3: 관리 콘솔에 접속이 안 됩니다
체크리스트:
- SSH 터널 창이 열려 있는지 확인 (닫으면 접속 끊김)
- 터널 명령어가 맞는지 확인:
ssh -L 18789:localhost:18789 root@{호스트명}.cafe24.com - 브라우저 주소가
http://localhost:18789인지 확인 (https가 아닌 http) - OpenClaw 서비스가 실행 중인지 확인:
systemctl status openclaw
문제 4: 봇이 메신저에서 응답하지 않습니다
체크리스트:
- 서비스가 실행 중인지 확인:
systemctl status openclaw - 실행 중이 아니라면 시작:
systemctl start openclaw - 로그에서 오류 확인:
journalctl -u openclaw -n 50 - 흔한 원인:
- API Key 만료 → 새 키 발급 후 config.yaml 수정 → 재시작
- API 잔액 부족 → 크레딧 충전
- 메신저 토큰 만료 → 토큰 재발급 후 config.yaml 수정 → 재시작
문제 5: 서비스가 자꾸 죽습니다 (멈춤)
| 원인 | 확인 방법 | 해결 |
|---|---|---|
| 메모리 부족 (OOM) | journalctl -u openclaw에서 OOM 메시지 | 사양 업그레이드 |
| 디스크 부족 | df -h로 디스크 사용량 확인 | 불필요 파일 정리 또는 사양 업그레이드 |
| 설정 오류 | 로그에서 config error 확인 | openclaw setup으로 재설정 |
재시작 명령어:
systemctl restart openclaw
지원 채널
문제가 해결되지 않는다면 아래 채널로 문의해 주세요:
| 채널 | 연락처 |
|---|---|
| 카페24 고객센터 (전화) | 1588-3284 |
| 카페24 고객센터 (온라인) | help.cafe24.com 내 1:1 문의 |
| 운영 시간 | 평일 09:00 ~ 18:00 (공휴일 제외) |
한 줄 요약: "나의 서비스 관리에서 '서버 상태 ON'만 확인하고, SSH로 openclaw setup 한 번 실행하면, 이후부터는 메신저에서 대화하는 것이 사용 방식입니다."