⏱ 예상 읽기: 약 9분
내 PC/서버에 직접 설치해 텔레그램·디스코드로 제어하는 셀프호스팅 AI 에이전트 플랫폼입니다.
외부 서버 없이 로컬 환경에서 Claude, GPT 등 LLM을 연결해 나만의 AI 직원을 구성할 수 있습니다.
노트북 뚜껑을 닫으면 내 AI 비서도 함께 잠들어 버리는 상황, 겪어보셨나요? 지금까지 로컬 환경에서 OpenClaw를 구축하고 보안까지 완벽하게 다졌지만, 진정한 자동화를 누리려면 내가 자는 동안에도 메신저에 응답하는 24시간 셀프호스팅 AI가 필수입니다. 그렇다고 복잡한 리눅스 서버 관리를 배우자니 막막하지 않으신가요?
이번 26편에서는 openclaw railway 배포와 Render 호스팅을 처음부터 끝까지 다룹니다. 복잡한 서버 관리 지식 없이 명령어 몇 줄만으로 클라우드에 24시간 돌아가는 AI 비서를 완성할 수 있습니다. Railway와 Render의 차이점, 배포 실전 과정, 환경 변수 설정과 영구 볼륨 연결까지 모두 다룹니다.
지난 편(이전: 보안 강화 완전 가이드 — 토큰·allowFrom·페어링 설정 총정리)에서는 토큰 관리, 파일 권한, dmPolicy 등 OpenClaw 보안 설정을 완벽하게 다졌습니다.
PaaS 호스팅이란? — Railway vs. Render 비교로 플랫폼 선택하기
클라우드 가상 서버(VPS)는 텅 빈 컴퓨터를 대여받아 운영체제부터 방화벽까지 모두 직접 설정해야 합니다. 반면 PaaS(Platform as a Service)는 GitHub 저장소를 연결하거나 명령어 한 줄만 입력하면 플랫폼이 알아서 환경을 구성하고 프로그램을 실행해 줍니다. 인프라 관리의 부담 없이 AI 에이전트 개발에만 집중할 수 있는 최고의 선택입니다.
Railway (강력 추천) — 빠른 속도와 직관적인 CLI
현재 개발자들 사이에서 가장 인기 있는 PaaS 플랫폼입니다. 배포 속도가 매우 빠르고 CLI 도구가 직관적이며, 한 달에 커피 한 잔 값(약 5달러 내외)으로 끊김 없는 24시간 AI 비서를 운영할 수 있습니다. openclaw railway 배포의 최우선 추천 플랫폼입니다.
Render — 무료 티어 제공, 테스트에 적합
무료 티어(Free Tier)를 제공해 비용 없이 배포를 테스트할 수 있습니다. 단, 15분 동안 외부 요청이 없으면 서버가 절전 모드(Sleep)로 진입하여, 봇에게 첫 메시지를 보냈을 때 30초 이상 응답 지연이 발생할 수 있습니다. 실시간 응답이 필요한 운영 환경보다는 기능 테스트에 더 적합합니다.
Railway에 OpenClaw 배포하기 — 실전 명령어 단계별 가이드
가장 추천하는 플랫폼인 Railway에 openclaw railway 배포를 진행하는 실전 과정입니다. 로컬 터미널에서 명령어 몇 번만 입력하면 클라우드 서버에 AI가 즉시 실행됩니다. 먼저 Railway 홈페이지에서 무료 계정을 생성하세요.
- 배포용 폴더 생성 및 railway.toml 설정 파일 작성빈 폴더를 만들고 Railway가 OpenClaw를 설치·실행하는 방법을 담은
railway.toml설정 파일을 생성합니다. # 배포용 폴더 생성 및 이동 mkdir my-openclaw-server && cd my-openclaw-server # Railway 배포 설정 파일 작성 cat << 'EOF' > railway.toml [build] builder = "NIXPACKS" buildCommand = "npm install -g openclaw@latest" [deploy] startCommand = "openclaw gateway run" restartPolicyType = "ON_FAILURE" EOF- Railway CLI 설치 및 계정 로그인Railway CLI 도구를 설치하고 계정과 연동합니다. 로그인 명령어 실행 시 브라우저가 자동으로 열리며 OAuth 인증이 진행됩니다.
# Railway CLI 설치 (macOS/Linux) brew install railway # Windows 사용자는 아래 명령어 사용 # npm i -g @railway/cli # Railway 계정 로그인 railway login- 프로젝트 초기화 및 클라우드 배포Railway에 새 프로젝트를 생성하고 즉시 클라우드로 업로드합니다.
railway up명령어 하나로 빌드부터 배포까지 자동 완료됩니다. # 새 프로젝트 생성 railway init # 클라우드로 즉시 배포 railway up- 배포 상태 확인 및 로그 모니터링배포 완료 후 터미널에 출력된 대시보드 URL에 접속하거나, 아래 명령어로 실시간 로그를 확인합니다. AI 게이트웨이가 정상 실행되고 있으면 배포 성공입니다!
# 실시간 배포 로그 확인 railway logs
git push만으로 자동 재배포(Auto Deploy)가 트리거됩니다. 코드 수정 후 터미널 명령어 없이도 클라우드가 자동 업데이트되는 CI/CD 환경을 무료로 구성할 수 있습니다.클라우드 배포 필수 설정 — 환경 변수와 영구 볼륨 연결
Railway에 배포했다고 끝이 아닙니다. AI가 API 키를 올바르게 인식하고, 서버 재시작 후에도 대화 메모리를 기억하게 하려면 반드시 두 가지 추가 설정이 필요합니다. 이 설정을 빠뜨리면 배포 후 AI가 응답하지 않거나, 재시작할 때마다 기억을 모두 잃는 상황이 발생합니다.
1. 환경 변수(Environment Variables) 등록
Railway 대시보드의 해당 프로젝트 → Variables 탭에서 아래 키-값 쌍을 등록합니다. 소스 코드나 설정 파일에 직접 키를 적어 올리는 것은 절대 금물입니다.
- OPENCLAW_AUTH_TOKEN: 게이트웨이 인증 토큰 (openssl rand -hex 32로 생성)
- ANTHROPIC_API_KEY: Anthropic Claude API 키
- TELEGRAM_BOT_TOKEN: 텔레그램 봇 토큰 (BotFather에서 발급)
- DISCORD_BOT_TOKEN: 디스코드 봇 토큰 (Discord 개발자 포털에서 발급)
.env나 openclaw.json 파일을 직접 커밋하지 마세요. .gitignore에 반드시 추가하고, 모든 비밀 키는 Railway/Render의 Variables 탭에서만 관리하세요. 공개 저장소에 API 키가 유출되면 수분 내로 해커 봇이 탐지하여 막대한 AI 과금을 발생시킵니다.2. 영구 볼륨(Persistent Volume) 마운트
PaaS 서버는 재시작될 때마다 내부 파일 시스템이 초기화됩니다. AI가 대화 기록과 설정을 기억하게 하려면 Railway 대시보드에서 Volume을 생성하고 /root/.openclaw 경로에 마운트해야 합니다. 이 설정 없이는 서버가 재시작될 때마다 모든 기억이 초기화됩니다.
# Railway CLI로 볼륨 마운트 경로 설정 (대시보드 UI 대신 CLI 사용 시)
railway volume add --mount /root/.openclaw
Render 무료 호스팅 배포 및 슬립 모드 해결법
비용 걱정 없이 먼저 기능을 테스트해 보고 싶다면 Render 무료 티어로 시작하세요. GitHub 계정이 있다면 Render 대시보드에서 버튼 세 번만 클릭하면 배포가 완료되는 가장 직관적인 방법도 지원합니다.
GitHub 연동으로 클릭 배포하기
Render 홈페이지에서 GitHub 계정으로 가입한 뒤, New → Web Service → GitHub Repo 연결 → Deploy 버튼 세 번으로 배포가 완료됩니다. 까만 터미널 창 없이도 배포가 가능하므로, 코딩이나 리눅스 지식이 전혀 없는 초보자에게 가장 추천하는 방법입니다.
슬립 모드 해결법 — UptimeRobot 무료 핑(Ping) 활용
Render 무료 티어의 슬립 모드가 불편하다면, UptimeRobot이라는 무료 서비스를 활용하세요. Render 서버 URL을 5분 간격으로 자동 핑(ping)하도록 설정하면 서버가 절전 모드로 진입하는 것을 막아 사실상 24시간 운영이 가능합니다.
📎 공식 문서 Hosting 섹션 보기 →
실전 팁과 주의사항
- 볼륨 마운트 필수:
/root/.openclaw경로에 Volume을 반드시 연결하세요. 연결하지 않으면 서버 재시작 시 모든 대화 기록과 페어링 정보가 사라집니다. - restartPolicyType ON_FAILURE 설정:
railway.toml의restartPolicyType = "ON_FAILURE"옵션은 예기치 않은 오류로 게이트웨이가 종료되면 자동으로 재시작합니다. 반드시 포함시키세요. - 로컬 설정 마이그레이션: 로컬에서 사용하던
~/.openclaw폴더의openclaw.json,sessions,workspace를 클라우드 볼륨에 복사하면 과거 대화 기록과 설정이 그대로 이어집니다. - 무료 티어 한계 인식: Render 무료 티어는 장기 운영보다 기능 검증용으로 사용하세요. 실시간 메신저 봇 운영에는 월 5달러 수준의 유료 플랜이 훨씬 안정적입니다.
자주 묻는 질문 (FAQ)
- Render 무료 호스팅으로 OpenClaw를 24시간 돌릴 수 있나요?
- 기술적으로는 가능하지만, 무료 티어에서는 15분 동안 요청이 없으면 서버가 절전 모드로 진입해 첫 메시지 응답이 30초 이상 지연될 수 있습니다. UptimeRobot으로 슬립 모드를 방지하거나, 완벽한 24시간 운영을 원한다면 Railway 또는 Render 유료 플랜(월 5달러 내외)을 권장합니다.
- 클라우드에 배포하면 API 키나 대화 내역이 해킹당할 위험은 없나요?
- GitHub 저장소에
.env나openclaw.json을 직접 커밋하지 않는 한 안전합니다. 모든 비밀 키는 Railway/Render의 Variables 탭에서만 관리하세요. PaaS 플랫폼 자체의 보안망 덕분에 오히려 개인 로컬 PC보다 안전할 수 있습니다. - 로컬 PC에서 쓰던 대화 메모리(SQLite)를 클라우드로 옮길 수 있나요?
- 네, 가능합니다. 로컬의
~/.openclaw폴더 안에 있는openclaw.json과sessions,workspace폴더를 압축한 뒤 클라우드 볼륨 내부에 CLI 도구로 그대로 복사해 넣으면 과거 대화 기록과 설정이 완벽하게 이어집니다. - 코딩이나 리눅스를 전혀 몰라도 클라우드 배포가 가능한가요?
- 물론입니다! GitHub 계정만 있다면 Render 웹사이트에서 'New Project → GitHub Repo 연결 → Deploy' 버튼 세 번만 누르면 배포가 끝납니다. 터미널 없이도 완성되는 가장 직관적인 AI 에이전트 인프라 구축법입니다.
이 글이 도움이 됐다면 댓글로 여러분의 경험을 알려주세요! 🙌
openclaw railway 배포에서 막히는 부분은 댓글에 남겨주세요 — 직접 답변드립니다.
📬 새 편 알림 받기 → AI 활용 가이드 구독
댓글