Railway에서 OpenClaw 시작하기: 터미널 없는 가장 쉬운 배포 방법

새로운 도구를 써보고 싶은데, 서버 구축부터 막히면 참 답답하죠. 터미널을 열고 복잡한 명령어를 입력하다 보면 정작 중요한 기능은 써보기도 전에 에너지를 다 쓰게 됩니다.

복잡한 설정 대신 브라우저 클릭 몇 번으로 해결하고 싶은 분들을 위해 가장 편한 방법을 준비했어요. Railway를 사용하면 서버 터미널을 건드리지 않고도 OpenClaw Gateway를 실행하고 /setup 웹 마법사로 모든 설정을 끝낼 수 있습니다.

필요한 것

시작하기 전에 다음 항목들이 준비되었는지 확인해 주세요.

• Railway 계정
• OpenClaw Railway 템플릿

빠른 시작

5분 안에 OpenClaw를 띄우는 가장 빠른 경로입니다.

1. 아래의 Deploy on Railway 버튼을 클릭하세요.
2. /data 경로에 마운트된 Volume을 추가하세요.
3. 필수 Variables를 설정하세요 (최소한 SETUP_PASSWORD는 꼭 필요합니다).
4. 8080 포트에 HTTP Proxy를 활성화하세요.
5. https://<your-railway-domain>/setup에 접속해 마법사를 완료하세요.

배포가 끝나면 Railway → 서비스 선택 → Settings → Domains에서 공개 URL을 확인할 수 있습니다. Railway에서 생성해준 도메인(https://<something>.up.railway.app)이나 직접 연결한 커스텀 도메인을 사용하면 됩니다.

접속 주소는 다음과 같습니다.

• https://<your-railway-domain>/setup: 설정 마법사 (비밀번호 보호)
• https://<your-railway-domain>/openclaw: 제어 UI

Required Railway settings

설정 시 다음 값들을 정확하게 입력해야 합니다.

Public Networking

서비스의 HTTP Proxy를 활성화하세요.

• Port: 8080

Volume (필수)

다음 경로에 Volume을 연결하세요.

• /data

Variables

서비스에 다음 환경 변수들을 설정하세요.

• SETUP_PASSWORD (필수)
• PORT=8080 (필수 — Public Networking의 포트와 일치해야 합니다)
• OPENCLAW_STATE_DIR=/data/.openclaw (권장)
• OPENCLAW_WORKSPACE_DIR=/data/workspace (권장)
• OPENCLAW_GATEWAY_TOKEN (권장 — 관리자 비밀 키로 취급하세요)

Setup flow

1. https://<your-railway-domain>/setup에 접속한 뒤 설정한 SETUP_PASSWORD를 입력하세요.
2. 사용하려는 모델 및 인증 제공업체를 선택하고 API 키를 입력하세요.
3. (선택 사항) Telegram, Discord, Slack 토큰을 추가하세요.
4. Run setup을 클릭하세요.

만약 Telegram DM이 페어링 모드로 설정되어 있다면, 설정 마법사에서 페어링 코드를 바로 승인할 수 있습니다.

Getting chat tokens

Telegram bot token

1. Telegram에서 @BotFather에게 메시지를 보냅니다.
2. /newbot 명령어를 실행하세요.
3. 생성된 토큰(123456789:AA... 형식)을 복사하세요.
4. OpenClaw의 /setup 페이지에 붙여넣으세요.

Discord bot token

1. Discord Developer Portal에 접속하세요.
2. New Application을 누르고 이름을 정하세요.
3. Bot 메뉴에서 Add Bot을 클릭하세요.
4. Privileged Gateway Intents 섹션에서 MESSAGE CONTENT INTENT를 활성화하세요. 이 설정을 하지 않으면 봇이 시작될 때 충돌이 발생합니다.
5. Bot Token을 복사해 /setup 페이지에 붙여넣으세요.
6. OAuth2 URL Generator를 통해 봇을 서버에 초대하세요 (필요 권한: bot, applications.commands).

문제 해결

설정 과정에서 문제가 생기면 다음 내용을 확인해 보세요.

• 봇이 시작 직후 종료되는 경우: Discord 봇 설정에서 MESSAGE CONTENT INTENT를 켰는지 다시 확인하세요. 이 권한이 없으면 봇이 정상적으로 실행되지 않습니다.
• 설정 저장이 안 되는 경우: Railway 설정에서 /data 경로에 Volume이 제대로 마운트되었는지 확인하세요. Volume이 없으면 재배포 시 설정이 사라질 수 있습니다.

Backups & migration

데이터를 옮겨야 한다면 다음 주소에서 백업을 다운로드할 수 있습니다.

• https://<your-railway-domain>/setup/export

이 기능은 OpenClaw의 상태와 워크스페이스를 내보내 줍니다. 나중에 다른 호스트로 이전하더라도 기존 설정과 메모리를 그대로 유지할 수 있습니다.

도움이 더 필요하신가요? AI Setup Assistant에게 물어보세요.

다음 단계

• OpenClaw 환경 변수 상세 가이드
• 커스텀 도메인 연결하기
• 모델 제공업체 설정 방법
• 고급 워크스페이스 활용법