在 Railway 上部署
在 Railway 上使用一键模板部署 Clawdbot，并在浏览器中完成设置。
这是最简单的"无需服务器终端"路径：Railway 为您运行 Gateway，
您可以通过 /setup 网络向导配置所有内容。
快速检查清单（新用户）
- 点击 Deploy on Railway（下方）。
- 添加挂载到
/data的卷。 - 设置所需的变量（至少
SETUP_PASSWORD）。 - 在端口
8080上启用 HTTP 代理。 - 打开
https://<your-railway-domain>/setup并完成向导。
一键部署
部署后，在 Railway → 您的服务 → Settings → Domains 中找到您的公开 URL。
Railway 将：
- 为您提供一个生成的域名（通常是
https://<something>.up.railway.app），或 - 使用您的自定义域名（如果您附加了一个）。
然后打开：
https://<your-railway-domain>/setup— 设置向导（密码保护）https://<your-railway-domain>/clawdbot— 控制 UI
您将获得
- 托管的 Clawdbot Gateway + 控制 UI
/setup处的网络设置向导（无需终端命令）- 通过 Railway 卷（
/data）实现的持久存储，使配置/凭据/工作空间在重新部署后保留 /setup/export处的备份导出，以便日后迁移出 Railway
必需的 Railway 设置
公开网络
为服务启用 HTTP 代理。
- 端口：
8080
卷（必需）
附加挂载到以下位置的卷：
/data
变量
在服务上设置这些变量：
SETUP_PASSWORD（必需）PORT=8080（必需 — 必须与公开网络中的端口匹配）CLAWDBOT_STATE_DIR=/data/.clawdbot（推荐）CLAWDBOT_WORKSPACE_DIR=/data/workspace（推荐）CLAWDBOT_GATEWAY_TOKEN（推荐；视为管理员密钥）
设置流程
- 访问
https://<your-railway-domain>/setup并输入您的SETUP_PASSWORD。 - 选择模型/身份验证提供商并粘贴您的密钥。
- （可选）添加 Telegram/Discord/Slack 令牌。
- 点击 运行设置。
如果 Telegram 私信设置为配对，设置向导可以批准配对码。
获取聊天令牌
Telegram 机器人令牌
- 在 Telegram 中向
@BotFather发送消息 - 运行
/newbot - 复制令牌（看起来像
123456789:AA...） - 将其粘贴到
/setup中
Discord 机器人令牌
- 访问 https://discord.com/developers/applications
- New Application → 选择一个名称
- Bot → Add Bot
- 在 Bot → Privileged Gateway Intents 下启用 MESSAGE CONTENT INTENT（必需，否则机器人在启动时会崩溃）
- 复制 Bot Token 并粘贴到
/setup中 - 将机器人邀请到您的服务器（OAuth2 URL Generator；范围：
bot、applications.commands）
备份与迁移
在以下位置下载备份：
https://<your-railway-domain>/setup/export
这将导出您的 Clawdbot 状态 + 工作空间，以便您可以迁移到另一个主机而不丢失配置或记忆。