> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 Railway 上部署

使用一键模板在 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` 并完成向导。

## 一键部署

<a href="https://railway.com/deploy/clawdbot-railway-template" target="_blank" rel="noreferrer">
  Deploy on Railway
</a>

部署完成后，在 **Railway → 你的服务 → Settings → Domains** 中找到你的公共 URL。

Railway 将会：

* 为你生成一个域名（通常类似 `https://<something>.up.railway.app`），或
* 如果你已绑定自定义域名，则使用你的自定义域名。

然后打开：

* `https://<your-railway-domain>/setup` — 设置向导（受密码保护）
* `https://<your-railway-domain>/openclaw` — 控制界面

## 你将获得

* 托管的 OpenClaw Gateway + 控制界面
* 位于 `/setup` 的网页设置向导（无需终端命令）
* 通过 Railway Volume（`/data`）实现的持久化存储，确保配置/凭据/工作区在重新部署后仍然保留
* 位于 `/setup/export` 的备份导出功能，便于日后迁移离开 Railway

## 必需的 Railway 设置

### 公共网络

为该服务启用 **HTTP Proxy**。

* 端口：`8080`

### Volume（必需）

挂载一个卷到：

* `/data`

### 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. 选择模型/认证提供商并粘贴你的密钥。
3. （可选）添加 Telegram/Discord/Slack 令牌。
4. 点击 **Run setup**。

如果 Telegram 私信设置为配对模式，设置向导可以批准配对代码。

## 获取聊天令牌

### Telegram 机器人令牌

1. 在 Telegram 中向 `@BotFather` 发送消息
2. 运行 `/newbot`
3. 复制令牌（类似 `123456789:AA...`）
4. 将其粘贴到 `/setup`

### Discord 机器人令牌

1. 前往 [https://discord.com/developers/applications](https://discord.com/developers/applications)
2. 点击 **New Application** → 选择名称
3. 进入 **Bot** → 点击 **Add Bot**
4. 在 Bot → Privileged Gateway Intents 下启用 **MESSAGE CONTENT INTENT**（必需，否则机器人启动时会崩溃）
5. 复制 **Bot Token** 并粘贴到 `/setup`
6. 将机器人邀请到你的服务器（使用 OAuth2 URL Generator；scopes：`bot`、`applications.commands`）

## 备份与迁移

在以下地址下载备份：

* `https://<your-railway-domain>/setup/export`

这将导出你的 OpenClaw 状态和工作区，使你可以迁移到其他主机而不会丢失配置或记忆。