메인 콘텐츠로 건너뛰기
원클릭 템플릿으로 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를 완료합니다.

​
원클릭 배포

Deploy on Railway 배포 후 공개 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로 이동합니다.
  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로 옮길 수 있습니다.