logo

quickActions

icon

OpenClaw 🦞

CPU 2 CoresRAM 2 GB

OpenClaw 🦞（原 Clawdbot、Moltbot）是一个个人 AI 助手，可在本地运行并通过 WebSocket Gateway 架构连接多个消息平台（WhatsApp、Telegram、Slack、Discord 等）。

template cover
部署次数12158 次
发布者zeaburZeabur
创建于2026-01-26
模版内的服务
service icon
标签
AIAssistantChatbotWhatsAppTelegramSlackDiscord

OpenClaw 🦞

OpenClaw 🦞（原 Clawdbot、Moltbot）是一个个人 AI 助手，可在本地运行并通过 WebSocket Gateway 架构连接多个消息平台。

⚠️ 本模板使用 ghcr.io/openclaw/openclaw:2026.2.2。OpenClaw 🦞 正在快速开发中，可能存在尚未发现的 bug。更改版本后也无法确保稳定性。

⚠️ 如果遇到任何问题，欢迎到 GitHub issues 寻找解决方案或回报新问题。Zeabur 平台相关问题请联系 Zeabur 支持。

⚠️ macOS 特有的软件与套件（如 Homebrew）无法在此容器环境中使用，请寻找其他替代方案。

⚠️ 本模板已预先配置好可直接使用，不需要运行设置向导。如果要运行向导，请记得将 bind 设置为 lan 模式，或参考官方文档进行更高级的配置。

建议资源配置

  • 最低配置：2 vCPU / 4 GB RAM
  • 建议配置：4 vCPU / 8 GB RAM

功能扩充

  • 浏览器：如需浏览器功能（网页浏览、截图等），请部署 Browser 模板

使用方式

  1. 部署完成后，在使用说明页签复制「Web UI (with token)」网址，贴到浏览器打开（首次登录需要 token，之后可直接打开网址）
  2. 设置 AI 模型（二选一）：
    • Zeabur AI Hub（默认模型：gpt-5-mini）：若部署时已输入 API Key，直接前往步骤 3。也可之后在 Zeabur 控制台的变量页签添加 ZEABUR_AI_HUB_API_KEY（添加后记得重新启动服务）。
    • 其他供应商（Anthropic、OpenAI 等）：若未输入 Zeabur AI Hub API Key，默认模型为 anthropic/claude-opus-4-5。前往 Web UI Settings 或环境变量添加 API 密钥。详情请见：https://docs.openclaw.ai/providers/anthropic
  3. 前往 Chat 页面测试 AI 模型是否正常运作
  4. （可选）设置 Telegram、WhatsApp 等通讯平台

AI 模型设置请参阅官方文档。

Telegram 机器人设置

从 BotFather 获取 Token：

  1. 打开 Telegram 并搜索 @BotFather
  2. 发送 /newbot 创建新机器人
  3. 按照提示设置机器人的名称和用户名
  4. BotFather 会发送 Token 给您（例如 123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

将 Token 添加到 Zeabur：

  1. 前往 Zeabur 控制台的服务环境变量页签
  2. 添加 TELEGRAM_BOT_TOKEN 并填入您的 Token
  3. 重新启动服务

配对您的 Telegram 账号：

  1. 在 Telegram 向您的机器人发送 /start
  2. 机器人会回复配对码（例如 JN4MSY23）
  3. 使用以下任一方式核准配对：
    • 网页 Chat：在 OpenClaw 网页界面的对话框输入 openclaw pairing approve telegram <配对码>
    • 终端：在 Zeabur 控制台打开命令进入容器终端，执行 openclaw pairing approve telegram <配对码>
  4. 看到 Approved telegram sender <user-id>. 表示配对成功
  5. 现在可以开始与机器人对话了！

WhatsApp 设置

步骤 1：配置 WhatsApp 频道 通过 OpenClaw Web UI（Settings → Config）或贴到对话框添加以下配置：

"channels": {
  "whatsapp": {
    "selfChatMode": true,
    "dmPolicy": "allowlist",
    "allowFrom": ["+15551234567"]
  }
}

将 +15551234567 替换为您的 WhatsApp 电话号码（含国码）。保存后重新启动服务。

步骤 2：连接 WhatsApp

  1. 在 Zeabur 控制台打开命令进入容器终端
  2. 执行：openclaw channels login
  3. 会出现 QR Code - 使用您手机上的 WhatsApp 扫描
  4. 连接完成！现在您可以在 WhatsApp 中给自己发消息来与 OpenClaw 对话

如需设置其他通讯平台（Discord、Slack 等），请参阅 Channels 文档。

AI 模型设置

确认模型是否正常运作：

  1. 默认模型取决于部署方式：
    • 有填 Zeabur AI Hub API Key → 默认模型：zeabur-ai/gpt-5-mini
    • 没有填 → 默认模型：anthropic/claude-opus-4-5（需要 API 密钥）
  2. 打开 Chat 页面，发送一条测试消息
  3. 如果收到回复 → 模型正常运作
  4. 如果出现错误 → 确认 API 密钥是否正确设置

切换本次对话的模型（通过聊天命令）：

  • /models - 查看可用模型
  • /model <model-id> - 仅在本次对话中切换模型（不影响其他对话）

修改所有新对话的默认模型（通过 Web UI Settings）：

  • 前往 Settings → Agents → Default model
  • 建议： 将低费用的模型设为默认（如 gemini-2.5-flash-lite、gpt-5-nano）。当模型无法使用时，可用 /new 开启新对话，自动切回默认模型。

添加 AI 供应商（通过 Web UI Settings 或环境变量）：

修改 Zeabur AI Hub 模型（通过 Zeabur 控制台）：

  • 前往设置 → 配置文件 → 编辑 /opt/openclaw/providers/zeabur-ai-hub.json5
  • 旧版（没有这些命令）：通过文件页签或 Web UI Settings 编辑 /home/node/.openclaw/openclaw.json，将以下内容加入 models.providers.zeabur-ai.models 数组：
{ "id": "gpt-5.2", "name": "GPT-5.2", "reasoning": false, "input": ["text", "image"], "cost": { "input": 1.5, "output": 12, "cacheRead": 0.15, "cacheWrite": 0 }, "contextWindow": 400000, "maxTokens": 8192 },
{ "id": "gpt-5.1", "name": "GPT-5.1", "reasoning": false, "input": ["text", "image"], "cost": { "input": 1.35, "output": 11, "cacheRead": 0.14, "cacheWrite": 0 }, "contextWindow": 400000, "maxTokens": 8192 },
{ "id": "gpt-5-nano", "name": "GPT-5 Nano", "reasoning": false, "input": ["text", "image"], "cost": { "input": 0.1, "output": 0.8, "cacheRead": 0.01, "cacheWrite": 0 }, "contextWindow": 400000, "maxTokens": 8192 },
{ "id": "glm-4.7", "name": "GLM-4.7", "reasoning": false, "input": ["text", "image"], "cost": { "input": 0.5, "output": 2, "cacheRead": 0.12, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 8192 },
{ "id": "glm-4.7-flash", "name": "GLM-4.7 Flash", "reasoning": false, "input": ["text", "image"], "cost": { "input": 0.25, "output": 1, "cacheRead": 0.06, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 8192 },
{ "id": "kimi-2.5", "name": "Kimi 2.5", "reasoning": false, "input": ["text"], "cost": { "input": 0.45, "output": 2, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 131072, "maxTokens": 8192 }

数据持久化

所有数据存储在 /home/node：

  • /home/node/.openclaw - 配置、会话、设备和凭证
  • /home/node/.openclaw/workspace - 工作区和记忆文件

备份与还原

💡 建议： 在完成初始设置或进行重大配置变更后，建议先创建备份。

备份：

  • 方法一：Zeabur 备份服务（推荐） - 使用 Zeabur 内置的备份功能。请参阅 Zeabur 备份文档。
  • 方法二：手动备份 - 打开命令 → 执行 backup → 从文件页签的 /home/node 下载（例如 backup-1430.tar.gz）
    • 旧版（没有这些命令）：cd /home/node && tar -czvf backup.tar.gz .openclaw

还原：

  1. 在文件页签将备份文件上传到 /home/node 文件夹
  2. 打开命令执行：
    • Zeabur 备份服务的文件：restore <备份文件名> --strip 2
    • 手动备份的文件：restore <备份文件名>
    • 旧版（没有这些命令）：cd /home/node && tar -xzvf <备份文件名>
  3. 重新启动服务

⚠️ 还原会覆盖新服务上现有的配置和数据。记得也要将相关的环境变量（如 TELEGRAM_BOT_TOKEN）设置回去。Channel 的备份还原目前只测试过 Telegram 和 WhatsApp 可以成功还原。

从 Clawdbot / Moltbot 迁移

旧版（没有这些命令）数据位置：

  • Clawdbot：配置 ~/.clawdbot、工作区 ~/clawd
  • Moltbot：配置 ~/.moltbot 或 ~/.clawdbot、工作区 ~/clawd

新版 OpenClaw 位置：/home/node/.openclaw（包含配置和工作区）

OpenClaw 具有向下兼容性，会自动读取 .clawdbot 和 .moltbot 文件夹，直接解压缩即可使用，不需要重命名。

迁移步骤：

  1. 在旧服务上备份数据：
    • 在旧服务打开命令
    • cd /home/node && tar -czvf backup.tar.gz .clawdbot .moltbot clawd 2>/dev/null（会忽略不存在的文件夹）
    • 从文件页签下载 backup.tar.gz
  2. 部署这个新的 OpenClaw 模板
  3. 将备份还原到新服务：
    • 将 backup.tar.gz 拖移到文件页签的 /home/node 文件夹
    • 打开命令：cd /home/node && tar -xzvf backup.tar.gz && rm backup.tar.gz
    • 重新启动服务
  4. 您的配置、对话记录和凭证都会保留

为了向下兼容，clawdbot 和 moltbot CLI 命令仍可使用。

疑难排解

配置文件改坏导致服务无法启动？ 使用救援模式：

  1. 前往设置 → 启动命令，改成：/opt/openclaw/rescue.sh（旧版没有这些命令，可用 sleep infinity）
  2. 前往设置 → 健康检查，关闭它（救援模式不会响应健康检查）
  3. 重新启动服务 - 容器会运行但不启动 OpenClaw
  4. 打开文件页签进入文件浏览器
  5. 从日志中查看错误原因，例如：Invalid config at /home/node/.openclaw/openclaw.json: - agents.list.0: Unrecognized key: "allowModels" — 在文件浏览器中修复 /home/node/.openclaw/openclaw.json，或打开命令执行 openclaw doctor --fix 自动移除无法识别的配置项
  6. 将启动命令改回：/opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh
    • 旧版（没有这些命令）：node dist/index.js gateway --allow-unconfigured --bind "${OPENCLAW_GATEWAY_BIND}" --port "${OPENCLAW_GATEWAY_PORT}" --token "${OPENCLAW_GATEWAY_TOKEN}"
  7. 重新开启健康检查并重新启动服务

更新版本： 前往设置 → 服务镜像来源 → 修改 ghcr.io/openclaw/openclaw:<tag>。

健康检查错误 Startup probe failed: dial tcp ... connect: connection refused？ 表示服务尚未启动完成或端口未就绪。OpenClaw 可能需要更多时间启动，特别是首次启动时。尝试：

  1. 等待几分钟 — 服务可能仍在初始化中
  2. 如果错误持续，增加资源配置（最低 2 vCPU / 4 GB RAM，建议 4 vCPU / 8 GB RAM）
  3. 如果服务不断重启，暂时关闭健康检查以防止重启循环，再查看日志找出实际错误

Zeabur 专属配置

此模板停用了 mDNS/Bonjour（OPENCLAW_DISABLE_BONJOUR=1），因为 Zeabur 容器主机名称可能超过 63 bytes 的 DNS 标签限制。mDNS 仅用于区域网络发现（类似 AirPlay/Chromecast），在云端环境中服务通过内部 DNS 连接，因此不需要此功能。

文档

更新日志

2026/2/4

  • 使用 Zeabur configs 管理启动脚本（更易维护）
  • 新增 backup 和 restore 全局命令
  • 新增 rescue.sh 救援模式，配置文件改坏时可用
  • Zeabur AI Hub 新增 6 个模型：gpt-5.2, gpt-5.1, gpt-5-nano, glm-4.7, glm-4.7-flash, kimi-2.5
  • Zeabur AI Hub 的 Claude 模型加入 store 兼容性设置

2026/2/2

  • 新增 AI 模型设置区块（全局 vs 本次对话设置）
  • 新增从 Clawdbot / Moltbot 迁移指南及数据路径
  • 新增备份与还原区块，支持 Zeabur 备份服务
  • 新增初始设置完成后备份提醒
  • 移除 Google Gemini CLI patch（上游已修复）
  • 移除部署时的 ANTHROPIC_API_KEY 和 OPENAI_API_KEY 变量，避免 OpenClaw 检测到空的 API Key 然后执行失败（可之后通过 Web UI 或环境变量设置）