Railway

Railway

Deploy OpenClaw on Railway with a one-click template and access it through the web Control UI. This is the easiest "no terminal on the server" path: Railway runs the Gateway for you.

Quick checklist (new users)

1. Click Deploy on Railway (below).
2. Add a Volume mounted at
   text

   Copy

   /data
   .
3. Set the required Variables (at least
   text

   Copy

   OPENCLAW_GATEWAY_PORT
   and
   text

   Copy

   OPENCLAW_GATEWAY_TOKEN
   ).
4. Enable HTTP Proxy on port
   text

   Copy

   8080
   .
5. Open
   text

   Copy

   https://<your-railway-domain>/openclaw
   and connect using the configured shared secret. This template uses
   text

   Copy

   OPENCLAW_GATEWAY_TOKEN
   by default; if you replace it with password auth, use that password instead.

One-click deploy

Deploy on Railway

After deploy, find your public URL in Railway → your service → Settings → Domains.

Railway will either:

• give you a generated domain (often
  text

  Copy

  https://<something>.up.railway.app
  ), or
• use your custom domain if you attached one.

Then open:

• text

  Copy

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

What you get

• Hosted OpenClaw Gateway + Control UI
• Persistent storage via Railway Volume (
  text

  Copy

  /data
  ) so
  text

  Copy

  openclaw.json
  , per-agent
  text

  Copy

  auth-profiles.json
  , channel/provider state, sessions, and workspace survive redeploys

Required Railway settings

Public Networking

Enable HTTP Proxy for the service.

• Port:
  text

  Copy

  8080

Volume (required)

Attach a volume mounted at:

• text

  Copy

  /data

Variables

Set these variables on the service:

• text

  Copy

  OPENCLAW_GATEWAY_PORT=8080
  (required — must match the port in Public Networking)
• text

  Copy

  OPENCLAW_GATEWAY_TOKEN
  (required; treat as an admin secret)
• text

  Copy

  OPENCLAW_STATE_DIR=/data/.openclaw
  (recommended)
• text

  Copy

  OPENCLAW_WORKSPACE_DIR=/data/workspace
  (recommended)

Connect a channel

Use the Control UI at

or run via Railway's shell for channel setup instructions:

• Telegram (fastest — just a bot token)
• Discord
• All channels

Backups & migration

Export your state, config, auth profiles, and workspace:

bash
Copy
openclaw backup create

This creates a portable backup archive with OpenClaw state plus any configured workspace. See Backup for details.

Next steps

• Set up messaging channels: Channels
• Configure the Gateway: Gateway configuration
• Keep OpenClaw up to date: Updating