logo

quickActions

icon

OpenClaw 🦞

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

template cover
部署次数18970 次
发布者zeaburZeabur
创建于2026-01-26
模版内的服务
service icon
最低配置2 Cores4 GB
推荐配置4 Cores8 GB
标签
AIAssistantChatbotWhatsAppTelegramSlackDiscord

OpenClaw 🦞

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

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

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

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

⚠️ 此模板需要在 Zeabur 上使用专用服务器，无法在共享集群上运行。

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

建议资源配置

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

功能扩充

  • 浏览器：如需浏览器功能（网页浏览、截图等），请部署 Browser 模板
  • Devbox：如需多语言程序执行（Python、Go、Rust、C/C++），请将 Devbox 模板 部署到同一个项目

使用方式

  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. 重新启动服务
  4. 重启后 Telegram 插件会自动启用。若机器人未启动，请前往 Settings → Config 确认插件已启用："plugins": { "entries": { "telegram": { "enabled": true } } }。如需停用，将 enabled 设为 false。

配对您的 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 对话

LINE 机器人设置

创建 LINE Messaging API 频道：

  1. 若尚未创建 LINE 官方账号，请先创建一个
  2. 前往 LINE Developers Console
  3. 创建或选择一个 Provider
  4. 创建新的 Messaging API 频道，并关联您的 LINE 官方账号
  5. 在 Messaging API 页签中，签发 Channel access token（长期有效）
  6. 在 Basic settings 页签中，复制 Channel secret

将凭证添加到 Zeabur：

  1. 前往 Zeabur 控制台的服务环境变量页签
  2. 添加 LINE_CHANNEL_ACCESS_TOKEN 并填入您的 Channel access token
  3. 添加 LINE_CHANNEL_SECRET 并填入您的 Channel secret
  4. 重新启动服务
  5. 重启后 LINE 插件会自动启用。若机器人未启动，请前往 Settings → Config 确认插件已启用："plugins": { "entries": { "line": { "enabled": true } } }

设置 Webhook：

  1. 重启后，您的 Webhook URL 为：https://<your-domain>/line/webhook
  2. 在 LINE Developers Console 中，前往频道的 Messaging API 页签
  3. 将 Webhook URL 设为 https://<your-domain>/line/webhook
  4. 启用 Use webhook
  5. （建议）在 LINE 官方账号管理后台关闭自动回复消息和加入好友的欢迎消息

配对您的 LINE 账号：

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

如需设置其他通讯平台（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-k2.5", "name": "Kimi K2.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. 如果服务不断重启，暂时关闭健康检查以防止重启循环，再查看日志找出实际错误

Tailscale 私有网络访问（可选）

⚠️ 此功能仅适用于全新部署。旧版部署不包含 Tailscale 启动脚本，请重新部署模板才能使用此功能。

除了使用公开域名，您也可以通过 Tailscale 让 OpenClaw 仅在您的私有网络（tailnet）中访问，无需暴露到公网。

前置需求：

  • 一个 Tailscale 账号（免费方案即可）
  • 在 Tailscale Admin Console 创建一组 Auth Key（建议勾选 Reusable + Ephemeral）

步骤 1：设置环境变量 在 Zeabur 控制台的环境变量标签页添加：

  • TS_AUTHKEY（必填）：您的 Tailscale Auth Key（tskey-auth-xxx）。前往 Tailscale Admin Console → Keys 创建。未设置此变量时，Tailscale 设置会被完全跳过。
  • TS_HOSTNAME（可选）：在 tailnet 上的机器名称，决定您的访问网址（https://<TS_HOSTNAME>.<tailnet>.ts.net）。未设置时默认为 openclaw。

步骤 2：切换启动命令 前往设置 → 启动命令，改为：

/opt/openclaw/startup.sh && /opt/openclaw/start_gateway_tailscale.sh

重新启动服务。

步骤 3：在本机安装 Tailscale 在您要访问 OpenClaw 的设备上安装 Tailscale（macOS、Windows、iOS、Android、Linux），并使用创建 Auth Key 时的同一个 Tailscale 账号登录。

步骤 4：首次登录 Web UI 启动完成后，在浏览器打开（需在同一个 tailnet 的设备上）：

https://<TS_HOSTNAME>.<您的tailnet>.ts.net

您的 tailnet DNS 名称可在 Tailscale 管理控制台 → DNS 查询，完整网址也可在 Zeabur 控制台的服务日志中确认。

首次打开会显示 "pairing required"，使用以下任一方式登录：

  • 在网址后加上 token：https://<TS_HOSTNAME>.<您的tailnet>.ts.net?token=<GATEWAY_TOKEN>
  • 或在 Web UI 的 Overview 页面输入 Gateway Token

Gateway Token 可在 Zeabur 控制台的使用说明标签页或环境变量中找到（OPENCLAW_GATEWAY_TOKEN）。

步骤 5：连接 OpenClaw app（可选，以 macOS 为例）

  1. 在 Mac 上安装 OpenClaw for macOS 和 Tailscale
  2. 打开 OpenClaw app → Settings → General → 选择 Remote 模式
  3. Transport 选择 Direct (ws/wss)
  4. Gateway URL 填入 wss://<TS_HOSTNAME>.<您的tailnet>.ts.net
  5. 设备首次连接时需要配对核准 — 在 Web UI 的 Nodes 页面点击 approve

iOS 和 Android 的设置请参阅官方文档。

切换回公开域名模式： 将启动命令改回 /opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh 并重新启动即可。

Zeabur 专属配置

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

文档

更新日志

2026/2/16

  • 镜像标签切换为 latest，以跟上快速的安全性修复

2026/2/15

  • 新增 Tailscale 私有网络访问：用户可切换至 start_gateway_tailscale.sh，通过 tailnet 私有 HTTPS 访问，无需暴露到公网
  • 镜像升级至 2026.2.14

2026/2/10

  • 修复生图 skill：改用 /v1/chat/completions API，默认模型改为 gemini-2.5-flash-image
  • 修复 gpt-oss-120b、llama-3.3-70b、qwen-3-32 HTTP 500：加入 supportsStore: false 兼容性设置
  • 修正 gpt-oss-120b reasoning 标记（设为 true）
  • 还原脚本支持 .zip 格式（Zeabur 备份服务）
  • 启动时将频道环境变量（TELEGRAM_BOT_TOKEN、DISCORD_BOT_TOKEN、SLACK_BOT_TOKEN、SLACK_APP_TOKEN、LINE_CHANNEL_ACCESS_TOKEN、LINE_CHANNEL_SECRET）同步写入配置文件

2026/2/7

  • 修复 cron 排程无法主动发送通知：启动时自动检测已配置的频道作为 heartbeat 投递目标
  • 新部署自动初始化 HEARTBEAT.md 含可执行内容（避免空文件导致 heartbeat 被跳过）

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-k2.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 或环境变量设置）