Deploy Moltbot To Fly

核心用法

本技能指导用户在 Fly.io 平台部署 Moltbot(Clawdbot)——一款 AI 智能体网关服务。部署流程分为五个阶段：克隆仓库并生成网关 Token、配置 Fly.io 应用(fly.toml)与持久化卷、设置环境密钥、执行首次部署、创建配置文件并完成设备配对。

关键配置包括：CLAWDBOT_STATE_DIR=/data 确保状态持久化；--bind lan 允许 Fly 代理访问网关；http_service 使用新版 Fly 格式；2GB 内存避免 OOM。部署后需通过 SSH 创建 /data/moltbot.json 配置文件，其中 gateway.auth.token 必须与 CLAWDBOT_GATEWAY_TOKEN 环境变量完全一致。

访问时需使用带 Token 的 URL (?token=xxx)，浏览器会显示 "pairing required"，此时需通过 SSH 执行 Node.js 脚本将待处理设备从 pending.json 移动到 paired.json 完成授权。

显著优点

• 云端托管：Fly.io 全球节点提供高可用基础设施，无需维护物理服务器
• 持久化存储：1GB 卷保存配置、设备配对状态和对话历史，更新或重启不丢失
• Token 认证：32 字节十六进制令牌提供基础访问控制，URL 参数传递简化客户端配置
• 内存优化：NODE_OPTIONS 限制堆内存，shared-cpu-2x + 2GB 配置平衡成本与性能
• 快速回滚：fly apps destroy + 重建可在数分钟内从干净状态恢复

潜在缺点与局限性

• 手动配对流程：设备授权需 SSH 登录后执行 Node.js 脚本，无法通过 Web UI 自动完成，每次新浏览器/设备都需重复
• 配置易错：Token 必须同时存在于环境变量和 JSON 配置文件， mismatch 会导致 1008 认证失败；JSON 语法错误直接阻止网关启动
• DNS 延迟：首次部署后 2-5 分钟 DNS propagation，用户易误判为部署失败
• 调试困难：日志分散在 Fly 平台，网关初始化需 30-60 秒，"not listening" 错误信息模糊
• 安全边界：Token 暴露在 URL 参数中可能被浏览器历史、Referer 日志记录；缺乏内置 HTTPS 强制之外的加密传输选项

适合人群

• 已拥有 Fly.io 账户、熟悉 CLI 和 Docker 部署流程的开发者
• 需要 7×24 在线 AI 网关但不愿自建服务器的个人或小型团队
• 愿意通过 SSH/命令行完成设备授权的进阶用户(非纯 GUI 用户)

常规风险

| 风险类型 | 描述 | 缓解措施 |

|---------|------|---------|

| Token 泄露 | URL 参数中的 Token 被浏览器插件、代理服务器日志捕获 | 使用专用浏览器配置，部署后定期轮换 Token，避免在公共电脑访问 |

| 配置漂移 | SSH 手动编辑 JSON 引入语法错误或 Token 不一致 | 使用 heredoc 脚本原子写入，部署前本地验证 JSON |

| 状态丢失 | 未正确挂载卷或 CLAWDBOT_STATE_DIR 设置错误 | 部署后验证 `fly volumes list` 显示已挂载，SSH 检查 `/data` 目录内容 |

| 供应链风险 | 从 GitHub 拉取 clawdbot/clawdbot 仓库，Docker 镜像构建过程不透明 | 锁定特定 commit hash，启用 Fly 的远程构建缓存审计 |

| 成本失控 | auto_start_machines + min_machines_running=1 保持单实例运行，但流量突增可能产生意外费用 | 设置 Fly 账单告警，监控 `fly status` 实例数量 |

核心用法

本 Skill 是一份完整的部署指南文档，用于将 Moltbot（Clawdbot）AI 机器人部署至 Fly.io 云平台。整个流程分为五个阶段：仓库克隆与网关令牌生成、Fly.io 配置（包括 fly.toml 编写与持久化存储卷创建）、应用部署、配置文件创建（关键步骤，需确保令牌一致性），以及最终的 Web UI 访问与设备配对授权。

用户需依次执行 CLI 命令，包括 fly apps create、fly volumes create、fly secrets set 等 Fly.io 标准操作，最终通过带令牌参数的 URL 访问 Web 界面，并在 SSH 会话中运行 Node.js 脚本完成设备配对，实现完整的功能激活。

显著优点

1. 零代码门槛：纯 Markdown 文档形式，所有命令均为可复制的 CLI 示例，无需编程基础即可完成复杂容器化部署。

2. 生产级配置覆盖：详尽提供了内存优化（2GB 推荐）、持久化存储挂载、http_service 新格式等关键生产环境参数，避免常见部署陷阱。

3. 安全实践内置：全程使用 YOUR-TOKEN-HERE 占位符，无硬编码凭证；环境变量与配置文件分离管理，符合云原生安全最佳实践。

4. 故障排查体系完善：提供网关令牌不匹配、DNS 解析失败、配置验证错误等 6 类典型问题的诊断与修复方案，甚至包含"核选项"快速重建指南。

5. 可信依赖链：所有外部引用均指向 Fly.io 官方域名、GitHub 开源仓库及 Google DNS 等公认可信服务，无恶意软件供应链风险。

潜在缺点与局限性

1. 平台锁定：深度绑定 Fly.io 生态（fly.toml 语法、Fly Machines API），迁移至 AWS/GCP/Azure 需完全重写配置。

2. 手动步骤繁多：设备配对需 SSH 进入容器运行 Node.js 脚本，无法通过单一命令自动化完成，对 CI/CD 集成不友好。

3. 资源成本：2GB 内存配置在共享 CPU 实例上产生持续计费，对于个人轻量使用可能存在性价比考量。

4. 时效性依赖：Moltbot 与 Fly.io 平台更新可能导致配置失效，需定期同步官方文档（当前版本依赖 anthropic/claude-opus-4-5 模型引用）。

适合的目标群体

• 独立开发者：希望快速将开源 AI 机器人项目投入生产环境，缺乏 Kubernetes 或传统运维经验。
• 技术型产品经理：需要验证 Moltbot 功能原型，追求" tonight deploy, tomorrow demo"的敏捷节奏。
• 小团队技术负责人：为团队搭建内部 AI 助手基础设施，重视文档完备性与故障可恢复性。
• 云原生学习者：通过真实项目理解 Fly.io 持久化卷、Secrets 管理、服务发现等核心概念。

使用风险

1. 令牌管理风险：用户需手动确保 CLAWDBOT_GATEWAY_TOKEN 环境变量与配置文件中的 gateway.auth.token 完全一致，任何不匹配将导致认证失败（unauthorized: gateway token mismatch）。

2. DNS 传播延迟：首次部署后需等待 2-5 分钟 DNS 生效，期间可能误判部署失败而进行不必要的调试。

3. 状态持久化依赖：CLAWDBOT_STATE_DIR 环境变量必须正确设置为 /data 并与挂载卷匹配，否则重启后配置与设备配对信息将丢失。

4. 外部脚本执行：文档包含 curl -L https://fly.io/install.sh | sh 管道安装命令，虽来源可信但仍存在供应链攻击的理论风险，建议用户验证脚本哈希后执行。