用途
moltworker 用于在 Cloudflare Workers 上运行 OpenClaw（曾用名 Moltbot、Clawdbot）个人 AI 助手。它把 OpenClaw 打包进 Cloudflare Sandbox 容器，提供全托管、常驻在线的部署方式，无需自行托管服务器。项目定位为概念验证（proof of concept），并非官方支持，可能随时失效，需自行承担风险。
主要能力
- 在 Cloudflare Sandbox 容器中运行 OpenClaw 个人 AI 助手。
- Control UI：网关提供的网页聊天界面。
- 多渠道支持：Telegram、Discord、Slack。
- 设备配对：安全的私信认证，需要显式批准。
- 持久会话：跨会话保留聊天历史与上下文。
- Agent 运行时：可扩展的 AI 能力，含工作区与技能。
- 可选 R2 存储：实现容器重启后的数据持久化。
- 可选浏览器自动化（CDP shim）：支持网页抓取、截图、自动化测试等。
- 可选 Cloudflare AI Gateway：用于缓存、限流、分析与成本追踪。
- 内置技能：容器内预装 /root/clawd/skills/ 下的技能，如 cloudflare-browser（含 screenshot.js、video.js、cdp-client.js）。
使用方式
- 前置条件：Workers 付费计划（5 美元/月，Cloudflare Sandbox 容器必需）；Anthropic API 密钥（用于 Claude 访问），或使用 AI Gateway 的统一计费。Cloudflare Access、Browser Rendering、AI Gateway、R2 Storage 有免费额度。
- 部署后，使用令牌打开 Control UI：将 your-worker 替换为实际 worker 子域，YOUR_GATEWAY_TOKEN 替换为生成的令牌。首次请求可能需 1-2 分钟等待容器启动。
- 必须完成：设置 Cloudflare Access 保护管理界面；通过 /_admin/ 管理界面配对设备。
- 建议启用 R2 存储，使已配对设备和会话历史在容器重启后保留。
- 管理界面 /_admin/ 需要 Cloudflare Access 认证（本地开发可设 DEV_MODE=true）。
- 本地开发：创建 .dev.vars 文件；默认使用设备配对认证，新设备需经 /_admin/ 批准。
- 网关令牌：远程访问 Control UI 时需通过查询参数传递令牌；即使令牌有效，新设备仍需经 /_admin/ 批准。
- 持久存储（R2）：创建 R2 API Token（Object Read & Write 权限），选择 moltbot-data 桶，复制 Access Key ID 与 Secret Access Key；容器启动时若 R2 有备份数据则恢复到配置目录，运行中每 5 分钟同步一次，也可在管理界面手动备份。
- 容器生命周期：默认常驻（SANDBOX_SLEEP_AFTER=never），冷启动需 1-2 分钟；可配置空闲休眠以降低成本。
- 调试端点：启用 DEBUG_ROUTES=true 且经 Cloudflare Access 后，可访问 /debug/processes、/debug/logs、/debug/version。
- 可选聊天渠道、浏览器自动化（CDP）、Cloudflare AI Gateway（设置三个必需密钥，模型可用 CF_AI_GATEWAY_MODEL 指定 provider/model-id 格式）。
适用场景
- 希望以全托管方式部署个人 AI 助手、无需自建服务器的用户。
- 需要跨 Telegram、Discord、Slack 等多渠道使用 AI 助手的场景。
- 需要设备配对与访问控制的安全敏感场景。
- 需要浏览器自动化（抓取、截图、测试）的 Agent 任务。
- 需要持久化会话与配置的个人助理部署。
限制
- 实验性项目，非官方支持，可能随时失效。
- 需要 Workers 付费计划（5 美元/月），容器运行产生额外计算费用。
- 需要 Anthropic API 密钥或 AI Gateway 统一计费。
- 冷启动需 1-2 分钟。
- R2 挂载仅在生产环境有效，wrangler dev 下不可用。
- 本地开发中 wrangler dev 对 WebSocket 代理存在已知限制，HTTP 可用但 WebSocket 可能失败。
- Windows 下 Git 可能以 CRLF 检出脚本导致 start-openclaw.sh 退出码 126，需配置 LF 行尾。
- 设备列表命令因 WebSocket 连接开销需 10-15 秒。
- 通过网关一次只能使用一个提供商；多提供商需使用直接密钥。
- 旧版 AI_GATEWAY_API_KEY + AI_GATEWAY_BASE_URL 配置仍支持但已弃用。
