在 Railway 上部署

通过一键模板在 Railway 上部署 CoderClaw，并在浏览器中完成设置。 这是最简单的”无需在服务器上使用终端”的方式：Railway 为你运行 Gateway网关， 你只需通过 /setup 网页向导完成所有配置。

快速检查清单（新用户）

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

一键部署

Deploy on Railway

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

Railway 会：

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

然后打开：

• https://<your-railway-domain>/setup — 设置向导（需密码保护）
• https://<your-railway-domain>/coderclaw — 控制面板 UI

你将获得

• 托管的 CoderClaw Gateway网关 + 控制面板 UI
• /setup 网页设置向导（无需终端命令）
• 通过 Railway Volume（/data）实现持久化存储，配置/凭证/工作区在重新部署后不会丢失
• 在 /setup/export 导出备份，方便日后从 Railway 迁移

必需的 Railway 设置

公共网络

为服务启用 HTTP Proxy。

• 端口：8080

Volume（必需）

挂载一个 Volume 到：

• /data

变量

在服务上设置以下变量：

• SETUP_PASSWORD（必需）
• PORT=8080（必需 — 必须与公共网络中的端口一致）
• CODERCLAW_STATE_DIR=/data/.coderclaw（推荐）
• CODERCLAW_WORKSPACE_DIR=/data/workspace（推荐）
• CODERCLAW_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
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

这会导出你的 CoderClaw 状态和工作区，方便你迁移到其他主机而不丢失配置或记忆。