Railway의 원클릭 템플릿으로 OpenClaw를 배포하고 브라우저에서 설정을 마무리하세요.
서버에서 터미널을 직접 만질 필요가 없는 가장 간편한 방법입니다. Railway가 게이트웨이를 대신 실행해주고,
모든 설정은 /setup 웹 마법사에서 처리할 수 있습니다.
빠른 체크리스트 (처음 사용하는 분)
- 아래의 Deploy on Railway 버튼을 클릭합니다.
/data에 마운트되는 Volume을 추가합니다.- 필수 Variables를 설정합니다 (최소한
SETUP_PASSWORD). - 포트
8080에 대해 HTTP Proxy를 활성화합니다. https://<your-railway-domain>/setup을 열고 마법사를 완료합니다.
원클릭 배포
Deploy on Railway배포 후 Railway → 서비스 → Settings → Domains에서 공개 URL을 확인할 수 있습니다.
Railway에서 제공되는 도메인은 다음 중 하나입니다:
- 자동 생성된 도메인 (보통
https://<something>.up.railway.app형식) - 직접 연결한 커스텀 도메인
그런 다음 아래 주소로 접속하세요:
https://<your-railway-domain>/setup— 설정 마법사 (비밀번호 보호)https://<your-railway-domain>/openclaw— Control UI
제공되는 것
- 호스팅된 OpenClaw 게이트웨이 + Control UI
/setup의 웹 설정 마법사 (터미널 명령어 불필요)- Railway Volume(
/data)을 통한 영구 스토리지 — 설정, 인증 정보, 워크스페이스가 재배포에도 유지됨 /setup/export에서 백업 내보내기 — 나중에 Railway에서 다른 곳으로 마이그레이션 가능
필수 Railway 설정
퍼블릭 네트워킹
서비스에 대해 HTTP Proxy를 활성화하세요.
- 포트:
8080
Volume (필수)
다음 경로에 볼륨을 마운트하세요:
/data
환경 변수
서비스에 아래 변수들을 설정하세요:
SETUP_PASSWORD(필수)PORT=8080(필수 — 퍼블릭 네트워킹의 포트와 일치해야 함)OPENCLAW_STATE_DIR=/data/.openclaw(권장)OPENCLAW_WORKSPACE_DIR=/data/workspace(권장)OPENCLAW_GATEWAY_TOKEN(권장; 관리자 시크릿으로 취급)
설정 흐름
https://<your-railway-domain>/setup에 접속해서SETUP_PASSWORD를 입력합니다.- 모델/인증 프로바이더를 선택하고 API 키를 붙여넣습니다.
- (선택) Telegram/Discord/Slack 토큰을 추가합니다.
- Run setup을 클릭합니다.
Telegram DM이 페어링 모드로 설정된 경우, 설정 마법사에서 페어링 코드를 승인할 수 있습니다.
채팅 토큰 발급 방법
Telegram 봇 토큰
- Telegram에서
@BotFather에게 메시지를 보냅니다 /newbot을 실행합니다- 토큰을 복사합니다 (
123456789:AA...형식) /setup에 붙여넣습니다
Discord 봇 토큰
- https://discord.com/developers/applications에 접속합니다
- New Application → 이름을 정합니다
- Bot → Add Bot
- Bot → Privileged Gateway Intents에서 MESSAGE CONTENT INTENT를 활성화합니다 (필수 — 활성화하지 않으면 봇이 시작 시 충돌함)
- Bot Token을 복사해서
/setup에 붙여넣습니다 - 봇을 서버에 초대합니다 (OAuth2 URL Generator; scopes:
bot,applications.commands)
백업 및 마이그레이션
아래 주소에서 백업을 다운로드할 수 있습니다:
https://<your-railway-domain>/setup/export
OpenClaw의 상태와 워크스페이스를 내보내기하므로, 설정이나 메모리를 잃지 않고 다른 호스트로 마이그레이션할 수 있습니다.