> ## Documentation Index
> Fetch the complete documentation index at: https://openclawdoc.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Railway에 배포하기

> Railway 원클릭 템플릿으로 OpenClaw를 배포하고 `/setup` 웹 위저드로 초기 설정을 마치는 방법을 안내합니다.

원클릭 템플릿으로 Railway에 OpenClaw를 배포하고, 브라우저에서 설정을 마무리하세요.
이 방법은 "서버에서 터미널을 열지 않는" 가장 쉬운 경로입니다. Railway가 Gateway를 대신 실행하고,
설정은 `/setup` 웹 위저드에서 진행합니다.

## 빠른 체크리스트 (신규 사용자)

1. 아래의 **Deploy on Railway**를 클릭합니다.
2. `/data`에 마운트되는 **Volume**을 추가합니다.
3. 필요한 **Variables**를 설정합니다. 최소 `SETUP_PASSWORD`는 필요합니다.
4. 포트 `8080`에 **HTTP Proxy**를 활성화합니다.
5. `https://<your-railway-domain>/setup`를 열고 wizard를 완료합니다.

## 원클릭 배포

<a href="https://railway.com/deploy/clawdbot-railway-template" target="_blank" rel="noreferrer">
  Deploy on Railway
</a>

배포 후 공개 URL은 **Railway → your service → Settings → Domains**에서 찾을 수 있습니다.

Railway는 다음 중 하나를 제공합니다.

* 생성된 domain (대개 `https://<something>.up.railway.app`), 또는
* 연결한 custom domain

그다음 다음을 엽니다.

* `https://<your-railway-domain>/setup` — setup wizard (password protected)
* `https://<your-railway-domain>/openclaw` — Control UI

## 제공되는 것

* hosted OpenClaw Gateway + Control UI
* `/setup`의 web setup wizard (터미널 명령 불필요)
* Railway Volume (`/data`)을 통한 persistent storage. redeploy 후에도 config/credentials/workspace가 유지됩니다.
* 나중에 Railway 밖으로 옮길 때 사용할 `/setup/export` backup export

## 필요한 Railway 설정

### Public Networking

서비스에 대해 **HTTP Proxy**를 활성화합니다.

* Port: `8080`

### Volume (필수)

다음 위치에 마운트되는 volume을 연결합니다.

* `/data`

### Variables

서비스에 다음 variables를 설정합니다.

* `SETUP_PASSWORD` (필수)
* `PORT=8080` (필수, Public Networking 포트와 일치해야 함)
* `OPENCLAW_STATE_DIR=/data/.openclaw` (권장)
* `OPENCLAW_WORKSPACE_DIR=/data/workspace` (권장)
* `OPENCLAW_GATEWAY_TOKEN` (권장, 관리자 비밀로 취급)

## 설정 흐름

1. `https://<your-railway-domain>/setup`에 접속해 `SETUP_PASSWORD`를 입력합니다.
2. model/auth provider를 선택하고 키를 붙여 넣습니다.
3. (선택 사항) Telegram/Discord/Slack 토큰을 추가합니다.
4. **Run setup**을 클릭합니다.

Telegram DMs가 pairing으로 설정되어 있으면, setup wizard가 pairing code를 승인할 수 있습니다.

## 채팅 토큰 얻기

### Telegram bot token

1. Telegram에서 `@BotFather`에 메시지를 보냅니다.
2. `/newbot` 을 실행합니다.
3. 토큰을 복사합니다(예: `123456789:AA...`).
4. `/setup`에 붙여 넣습니다.

### Discord bot token

1. [https://discord.com/developers/applications](https://discord.com/developers/applications)로 이동합니다.
2. **New Application** → 이름 선택
3. **Bot** → **Add Bot**
4. Bot → Privileged Gateway Intents 아래에서 **Enable MESSAGE CONTENT INTENT**를 활성화합니다. 필수 항목이며, 빠지면 봇이 시작 시 crash합니다.
5. **Bot Token**을 복사해 `/setup`에 붙여 넣습니다.
6. 서버에 봇을 초대합니다. OAuth2 URL Generator에서 scopes는 `bot`, `applications.commands`를 사용합니다.

## 백업 및 마이그레이션

다음에서 backup을 내려받을 수 있습니다.

* `https://<your-railway-domain>/setup/export`

이 export는 OpenClaw state + workspace를 담고 있어, config나 memory를 잃지 않고 다른 host로 옮길 수 있습니다.