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

# Railway

# Railway

원클릭 템플릿으로 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">
  Deploy on Railway
</a>

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

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

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

그다음 다음을 여세요:

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

## 제공 내용

* 호스팅된 OpenClaw Gateway + Control UI
* Railway Volume(`/data`)을 통한 영구 스토리지로 `openclaw.json`,
  agent별 `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의 shell에서 `openclaw onboard`를 실행해 채널 설정 지침을 확인하세요:

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

## 백업 및 마이그레이션

상태, config, auth profiles, workspace를 export합니다:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw backup create
```

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

## 다음 단계

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