跳到主要内容

在 Railway 上部署

在 Railway 上通过一键模板部署 Clawdbot，并在浏览器中完成设置。 这是最简单的“无需服务器终端”路径：Railway 为你运行 Gateway， 你通过 /setup 网络向导配置一切。

快速清单（新用户）​

  1. 点击 Deploy on Railway（下方）。
  2. 添加一个挂载在 /data 的 Volume。
  3. 设置必要的 Variables（至少包含 SETUP_PASSWORD）。
  4. 在端口 8080 上启用 HTTP Proxy。
  5. 打开 https://<your-railway-domain>/setup 并完成向导。

一键部署​

Deploy on Railway

部署后，在 Railway → your service → Settings → Domains 中找到你的公开 URL。

Railway 将会：

  • 给你一个生成的域名（通常是 https://<something>.up.railway.app），或者
  • 使用你绑定的自定义域名。

然后打开：

  • https://<your-railway-domain>/setup —— 设置向导（受密码保护）
  • https://<your-railway-domain>/clawdbot —— Control UI

你将获得​

  • 托管的 Clawdbot Gateway + Control UI
  • 位于 /setup 的网络设置向导（无需终端命令）
  • 通过 Railway Volume (/data) 实现的持久化存储，使配置/凭据/工作区在重新部署后依然存在
  • 位于 /setup/export 的备份导出，方便以后迁移出 Railway

必要的 Railway 设置​

公开网络 (Public Networking)​

为服务启用 HTTP Proxy。

  • 端口：8080

卷 (Volume)（必填）​

附加一个挂载在以下位置的卷：

  • /data

变量 (Variables)​

在服务上设置这些变量：

  • SETUP_PASSWORD（必填）
  • PORT=8080（必填 —— 必须与公开网络中的端口匹配）
  • CLAWDBOT_STATE_DIR=/data/.clawdbot（推荐）
  • CLAWDBOT_WORKSPACE_DIR=/data/workspace（推荐）
  • CLAWDBOT_GATEWAY_TOKEN（推荐；请将其视为管理员密钥）

设置流程​

  1. 访问 https://<your-railway-domain>/setup 并输入你的 SETUP_PASSWORD。
  2. 选择一个模型/身份认证提供商并粘贴你的密钥。
  3. （可选）添加 Telegram/Discord/Slack 令牌。
  4. 点击 Run setup。

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

获取聊天令牌​

Telegram 机器人令牌 (Bot token)​

  1. 在 Telegram 中给 @BotFather 发消息
  2. 运行 /newbot
  3. 复制令牌（看起来像 123456789:AA...）
  4. 将其粘贴到 /setup 中

Discord 机器人令牌 (Bot token)​

  1. 前往 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；权限范围：bot, applications.commands）

备份与迁移​

在以下位置下载备份：

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

这会导出你的 Clawdbot 状态 + 工作区，以便你可以迁移到另一个主机而不会丢失配置或记忆。