/setup 웹 마법사를 통해 모든 것을 구성할 수 있습니다.
빠른 체크리스트 (신규 사용자)
- 아래의 Railway 에 배포를 클릭하세요.
/data에 마운트된 볼륨을 추가하세요.- 필요한 변수를 설정하세요 (최소한
SETUP_PASSWORD). - 포트
8080에서 HTTP Proxy를 활성화하세요. https://<your-railway-domain>/setup을 열고 마법사를 완료하세요.
클릭 한 번으로 배포하기
Railway 에 배포하기 배포 후, Railway → 여러분의 서비스 → 설정 → 도메인에서 공개 URL 을 찾으세요. Railway 는 다음 중 하나를 제공합니다:- 생성된 도메인 (종종
https://<something>.up.railway.app) 또는 - 연결한 커스텀 도메인.
https://<your-railway-domain>/setup— 설정 마법사 (비밀번호로 보호됨)https://<your-railway-domain>/openclaw— 제어 UI
제공되는 것
- 호스팅된 OpenClaw 게이트웨이 + 제어 UI
/setup에서 웹 설정 마법사 (터미널 명령어 없음)- Railway 볼륨(
/data)을 통한 지속 저장소로 재배포 시에도 설정/자격증명/작업공간 유지 - 나중에 Railway 를 떠날 수 있도록
/setup/export에서 백업 내보내기
필수 Railway 설정
공개 네트워킹
서비스에 대해 HTTP Proxy를 활성화하세요.- 포트:
8080
볼륨 (필수)
다음 위치에 마운트된 볼륨을 연결하세요:/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를 입력하세요.- 모델/인증 프로바이더를 선택하고 키를 붙여넣으세요.
- (선택 사항) Telegram/Discord/Slack 토큰을 추가하세요.
- Run setup을 클릭하세요.
채팅 토큰 얻기
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; 범위:
bot,applications.commands).
백업 및 마이그레이션
백업을 다운로드하세요:https://<your-railway-domain>/setup/export