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

# Railway 에 배포하기

클릭 한 번으로 OpenClaw 를 Railway 에 배포하고 브라우저에서 설정을 완료하세요. 이는 서버에서 터미널을 사용할 필요가 없는 가장 쉬운 방법입니다. Railway 가 게이트웨이를 실행해주고, `/setup` 웹 마법사를 통해 모든 것을 구성할 수 있습니다.

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

1. 아래의 **Railway 에 배포**를 클릭하세요.
2. `/data`에 마운트된 **볼륨**을 추가하세요.
3. 필요한 **변수**를 설정하세요 (최소한 `SETUP_PASSWORD`).
4. 포트 `8080`에서 **HTTP Proxy**를 활성화하세요.
5. `https://<your-railway-domain>/setup`을 열고 마법사를 완료하세요.

## 클릭 한 번으로 배포하기

<a href="https://railway.com/deploy/clawdbot-railway-template" target="_blank" rel="noreferrer">
  Railway 에 배포하기
</a>

배포 후, **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` (권장; 관리자 비밀처럼 취급)

## 설정 과정

1. `https://<your-railway-domain>/setup`에 방문하여 `SETUP_PASSWORD`를 입력하세요.
2. 모델/인증 프로바이더를 선택하고 키를 붙여넣으세요.
3. (선택 사항) Telegram/Discord/Slack 토큰을 추가하세요.
4. **Run setup**을 클릭하세요.

Telegram 다이렉트 메시지가 페어링으로 설정된 경우, 설정 마법사가 페어링 코드를 승인할 수 있습니다.

## 채팅 토큰 얻기

### Telegram 봇 토큰

1. Telegram 에서 `@BotFather`에게 메시지를 보내세요.
2. `/newbot`을 실행하세요.
3. 토큰을 복사하세요 (예: `123456789:AA...`)
4. `/setup`에 붙여넣으세요.

### Discord 봇 토큰

1. [https://discord.com/developers/applications](https://discord.com/developers/applications) 에 방문하세요.
2. **New Application** → 이름을 선택하세요.
3. **Bot** → **Add Bot**
4. Bot → Privileged Gateway Intents 에서 **MESSAGE CONTENT INTENT**를 활성화하세요 (필수, 그렇지 않으면 봇이 시작 시 충돌함).
5. **Bot Token**을 복사하여 `/setup`에 붙여넣으세요.
6. 봇을 서버에 초대하세요 (OAuth2 URL Generator; 범위: `bot`, `applications.commands`).

## 백업 및 마이그레이션

백업을 다운로드하세요:

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

이는 설정이나 메모리를 잃지 않고 다른 호스트로 마이그레이트할 수 있도록 OpenClaw 상태 + 작업공간을 내보냅니다.