---
read_when:
    - Railway에 OpenClaw를 배포하는 경우
    - 브라우저 기반 Control UI를 포함한 원클릭 클라우드 배포를 원하는 경우
summary: 원클릭 템플릿으로 Railway에 OpenClaw 배포
title: Railway
x-i18n:
    generated_at: "2026-04-05T12:47:11Z"
    model: gpt-5.4
    provider: openai
    source_hash: f59699aa4e9d27d50018acc2e89ed1bbb1b1a5c85e3fd52f2afe5b2c97b21720
    source_path: install/railway.mdx
    workflow: 15
---

원클릭 템플릿으로 Railway에 OpenClaw를 배포하고 웹 Control UI를 통해 액세스하세요.
이것이 "서버에서 터미널 없이" 사용할 수 있는 가장 쉬운 경로입니다. Railway가 Gateway를 대신 실행해 줍니다.

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

1. 아래의 **Deploy on Railway**를 클릭합니다.
2. `/data`에 마운트되는 **Volume**을 추가합니다.
3. 필수 **Variables**를 설정합니다(최소 `OPENCLAW_GATEWAY_PORT` 및 `OPENCLAW_GATEWAY_TOKEN`).
4. 포트 `8080`에서 **HTTP Proxy**를 활성화합니다.
5. `https://<your-railway-domain>/openclaw`를 열고 구성된 공유 시크릿을 사용해 연결합니다. 이 템플릿은 기본적으로 `OPENCLAW_GATEWAY_TOKEN`을 사용합니다. 이를 비밀번호 인증으로 바꾼 경우에는 해당 비밀번호를 사용하세요.

## 원클릭 배포

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

배포 후 공개 URL은 **Railway → your service → Settings → Domains**에서 확인하세요.

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

- 생성된 도메인(보통 `https://<something>.up.railway.app`), 또는
- 연결한 사용자 지정 도메인

그런 다음 다음을 엽니다.

- `https://<your-railway-domain>/openclaw` — Control UI

## 제공 내용

- 호스팅된 OpenClaw Gateway + Control UI
- Railway Volume (`/data`)을 통한 영구 스토리지로 `openclaw.json`,
  에이전트별 `auth-profiles.json`, 채널/provider 상태, 세션, 그리고
  workspace가 재배포 후에도 유지됩니다

## 필수 Railway 설정

### Public Networking

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

- 포트: `8080`

### Volume (필수)

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

- `/data`

### Variables

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

- `OPENCLAW_GATEWAY_PORT=8080` (필수 — Public Networking의 포트와 일치해야 함)
- `OPENCLAW_GATEWAY_TOKEN` (필수, 관리자 시크릿으로 취급)
- `OPENCLAW_STATE_DIR=/data/.openclaw` (권장)
- `OPENCLAW_WORKSPACE_DIR=/data/workspace` (권장)

## 채널 연결

채널 설정 지침은 `/openclaw`의 Control UI를 사용하거나 Railway의 셸을 통해 `openclaw onboard`를 실행해 확인하세요.

- [Telegram](/channels/telegram) (가장 빠름 — bot token만 있으면 됨)
- [Discord](/channels/discord)
- [All channels](/channels)

## 백업 및 마이그레이션

상태, config, 인증 프로필, workspace를 내보냅니다.

```bash
openclaw backup create
```

이 명령은 OpenClaw 상태와 구성된
workspace를 포함한 이식 가능한 백업 archive를 생성합니다. 자세한 내용은 [Backup](/cli/backup)을 참조하세요.

## 다음 단계

- 메시징 채널 설정: [Channels](/channels)
- Gateway 구성: [Gateway configuration](/gateway/configuration)
- OpenClaw 최신 상태 유지: [Updating](/install/updating)
