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 한 번 실행하면, 이후부터는 메신저에서 대화하는 것이 사용 방식입니다."