OpenClaw Railway Template (1‑click deploy)

This repo packages OpenClaw for Railway with a small /setup web wizard so users can deploy and onboard without running any commands.

What you get

• OpenClaw Gateway + Control UI (served at / and /openclaw)
• A friendly Setup Wizard at /setup (protected by a password)
• Persistent state via Railway Volume (so config/credentials/memory survive redeploys)
• One-click Export backup (so users can migrate off Railway later)

How it works (high level)

• The container runs a wrapper web server.
• The wrapper protects /setup with SETUP_PASSWORD.
• During setup, the wrapper runs openclaw onboard --non-interactive ... inside the container, writes state to the volume, and then starts the gateway.
• After setup, / is OpenClaw. The wrapper reverse-proxies all traffic (including WebSockets) to the local gateway process.

Getting chat tokens (so you don't have to scramble)

Telegram bot token

1. Open Telegram and message @BotFather
2. Run /newbot and follow the prompts
3. BotFather will give you a token that looks like: 123456789:AA...
4. Paste that token into /setup

Discord bot token

1. Go to the Discord Developer Portal: https://discord.com/developers/applications
2. New Application → pick a name
3. Open the Bot tab → Add Bot
4. Copy the Bot Token and paste it into /setup
5. Invite the bot to your server (OAuth2 URL Generator → scopes: bot, applications.commands; then choose permissions)

Local smoke test

docker build -t openclaw-railway-template .

docker run --rm -p 8080:8080 \
  -e PORT=8080 \
  -e SETUP_PASSWORD=test \
  -e OPENCLAW_STATE_DIR=/data/.openclaw \
  -e OPENCLAW_WORKSPACE_DIR=/data/workspace \
  -v $(pwd)/.tmpdata:/data \
  openclaw-railway-template

# open http://localhost:8080/setup (password: test)