コンテンツにスキップ
CoderClaw CoderClaw

Deploy on Railway

このコンテンツはまだ日本語訳がありません。

Deploy CoderClaw on Railway with a one-click template and finish setup in your browser. This is the easiest “no terminal on the server” path: Railway runs the Gateway for you, and you configure everything via the /setup web wizard.

Quick checklist (new users)

Section titled “Quick checklist (new users)”
  1. Click Deploy on Railway (below).
  2. Add a Volume mounted at /data.
  3. Set the required Variables (at least SETUP_PASSWORD).
  4. Enable HTTP Proxy on port 8080.
  5. Open https://<your-railway-domain>/setup and finish the wizard.

One-click deploy

Section titled “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 https://<something>.up.railway.app), or
  • use your custom domain if you attached one.

Then open:

  • https://<your-railway-domain>/setup — setup wizard (password protected)
  • https://<your-railway-domain>/coderclaw — Control UI

What you get

Section titled “What you get”
  • Hosted CoderClaw Gateway + Control UI
  • Web setup wizard at /setup (no terminal commands)
  • Persistent storage via Railway Volume (/data) so config/credentials/workspace survive redeploys
  • Backup export at /setup/export to migrate off Railway later

Required Railway settings

Section titled “Required Railway settings”

Public Networking

Section titled “Public Networking”

Enable HTTP Proxy for the service.

  • Port: 8080

Volume (required)

Section titled “Volume (required)”

Attach a volume mounted at:

  • /data

Variables

Section titled “Variables”

Set these variables on the service:

  • SETUP_PASSWORD (required)
  • PORT=8080 (required — must match the port in Public Networking)
  • CODERCLAW_STATE_DIR=/data/.coderclaw (recommended)
  • CODERCLAW_WORKSPACE_DIR=/data/workspace (recommended)
  • CODERCLAW_GATEWAY_TOKEN (recommended; treat as an admin secret)

Setup flow

Section titled “Setup flow”
  1. Visit https://<your-railway-domain>/setup and enter your SETUP_PASSWORD.
  2. Choose a model/auth provider and paste your key.
  3. (Optional) Add Telegram/Discord/Slack tokens.
  4. Click Run setup.

If Telegram DMs are set to pairing, the setup wizard can approve the pairing code.

Getting chat tokens

Section titled “Getting chat tokens”

Telegram bot token

Section titled “Telegram bot token”
  1. Message @BotFather in Telegram
  2. Run /newbot
  3. Copy the token (looks like 123456789:AA...)
  4. Paste it into /setup

Discord bot token

Section titled “Discord bot token”
  1. Go to https://discord.com/developers/applications
  2. New Application → choose a name
  3. Bot → Add Bot
  4. Enable MESSAGE CONTENT INTENT under Bot → Privileged Gateway Intents (required or the bot will crash on startup)
  5. Copy the Bot Token and paste into /setup
  6. Invite the bot to your server (OAuth2 URL Generator; scopes: bot, applications.commands)

Backups & migration

Section titled “Backups & migration”

Download a backup at:

  • https://<your-railway-domain>/setup/export

This exports your CoderClaw state + workspace so you can migrate to another host without losing config or memory.