Deploy no Railway | Docs

Coloque o OpenClaw para rodar no Railway com um template de um clique e finalize a configuracao direto no navegador. Esse e o caminho mais simples — sem terminal no servidor: o Railway cuida do Gateway, e voce configura tudo pelo assistente web em /setup.

Checklist rapido (novos usuarios)

Clique em Deploy on Railway (logo abaixo).
Adicione um Volume montado em /data.
Defina as Variaveis obrigatorias (no minimo SETUP_PASSWORD).
Ative o HTTP Proxy na porta 8080.
Acesse https://<seu-dominio-railway>/setup e finalize o assistente.

Deploy com um clique

Deploy on Railway

Apos o deploy, encontre sua URL publica em Railway → seu servico → Settings → Domains.

O Railway vai:

gerar um dominio automatico (normalmente https://<algo>.up.railway.app), ou
usar seu dominio personalizado, caso voce tenha configurado um.

Depois, acesse:

https://<seu-dominio-railway>/setup — assistente de configuracao (protegido por senha)
https://<seu-dominio-railway>/openclaw — Interface de Controle

O que voce ganha

Gateway OpenClaw + Interface de Controle hospedados
Assistente de configuracao web em /setup (sem comandos no terminal)
Armazenamento persistente via Volume do Railway (/data) — config, credenciais e workspace sobrevivem a redeploys
Exportacao de backup em /setup/export para migrar do Railway quando quiser

Configuracoes obrigatorias no Railway

Rede publica

Ative o HTTP Proxy para o servico.

Porta: 8080

Volume (obrigatorio)

Anexe um volume montado em:

/data

Variaveis

Defina estas variaveis no servico:

SETUP_PASSWORD (obrigatorio)
PORT=8080 (obrigatorio — precisa corresponder a porta em Public Networking)
OPENCLAW_STATE_DIR=/data/.openclaw (recomendado)
OPENCLAW_WORKSPACE_DIR=/data/workspace (recomendado)
OPENCLAW_GATEWAY_TOKEN (recomendado; trate como um segredo administrativo)

Fluxo de configuracao

Acesse https://<seu-dominio-railway>/setup e insira seu SETUP_PASSWORD.
Escolha um provedor de modelo/autenticacao e cole sua chave.
(Opcional) Adicione tokens do Telegram/Discord/Slack.
Clique em Run setup.

Se as DMs do Telegram estiverem configuradas para pareamento, o assistente pode aprovar o codigo de pareamento.

Obtendo tokens de chat

Token de bot do Telegram

Envie uma mensagem para @BotFather no Telegram
Execute /newbot
Copie o token (algo como 123456789:AA...)
Cole em /setup

Token de bot do Discord

Acesse https://discord.com/developers/applications
New Application → escolha um nome
Bot → Add Bot
Ative MESSAGE CONTENT INTENT em Bot → Privileged Gateway Intents (obrigatorio, senao o bot trava ao iniciar)
Copie o Bot Token e cole em /setup
Convide o bot para seu servidor (OAuth2 URL Generator; scopes: bot, applications.commands)

Backups e migracao

Baixe um backup em:

https://<seu-dominio-railway>/setup/export

Isso exporta seu estado do OpenClaw + workspace para que voce possa migrar para outro host sem perder configuracoes ou memoria.