Clawdbot

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

⚠️ 开发中

此模板正在开发中。由于 Clawdbot 正在快速开发，本模板使用 main tag 以获取最新版本。

✅ 已完成

• Gateway 启动并接受 WebSocket 连接
• Web UI 可通过公开域名加载
• Token 认证（无需设备配对）
• AI 供应商认证（Anthropic API 密钥）
• 通过 Web UI 与 AI 助手对话
• Zeabur AI Hub 集成
• Telegram 机器人连接

🔄 测试中

• WhatsApp 连接（QR code 登录）
• Discord 机器人连接
• Slack 集成

---

建议资源配置

资源需求可能因使用的工具和功能而异。

• 共享集群：2000 m（2 vCPU）、2048 Mi（2 GB）
• 专用服务器：推荐使用以获得更好的性能

支持平台

• WhatsApp
• Telegram
• Slack
• Discord
• 更多消息平台

使用方式

1. 部署完成后，系统会自动生成一组安全的 Gateway Token
2. 在使用说明页签找到预先生成的 URL
3. 点击「Web UI (with token)」链接直接连接（Token 已包含在 URL 中）
4. 看到 Clawdbot 界面即表示部署完成
5. 前往 Chat 页面测试 AI 供应商是否正常运作

更多详情请参阅官方文档。

配置

• ZEABUR_AI_HUB_API_KEY：您的 Zeabur AI Hub API 密钥（推荐）。在此获取 API 密钥
• ANTHROPIC_API_KEY：您的 Anthropic Claude API 密钥
• OPENAI_API_KEY：您的 OpenAI API 密钥（选填，用于 OpenAI 功能如记忆搜索、TTS 等）

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. 在 Zeabur 控制台打开命令进入容器终端
4. 执行：clawdbot pairing approve telegram <配对码>
5. 看到 Approved telegram sender <user-id>. 表示配对成功
6. 现在可以开始与机器人对话了！

更多配置方式

除了环境变量外，您也可以通过以下方式配置 Clawdbot：

Web UI

1. 打开 Clawdbot Web UI
2. 前往 Settings 配置模型、频道和偏好设置

命令行

1. 在 Zeabur 控制台打开命令
2. 使用 clawdbot 命令管理供应商、模型和设置

修改默认模型

默认模型为 zeabur-ai/gpt-5-mini。修改方式：

通过 Web UI：

1. 在 Clawdbot Web UI 打开 Settings
2. 从列表中选择您偏好的模型

通过命令行：

clawdbot config set agents.defaults.model.primary zeabur-ai/claude-sonnet-4-5

可用模型： gemini-3-pro-preview, gpt-5, claude-sonnet-4-5, gemini-3-flash-preview, gpt-5-mini, claude-haiku-4-5, gemini-2.5-flash, deepseek-v3.2

数据持久化

• /home/node/.clawdbot - 配置、会话和凭证
• /home/node/clawd - 工作区和记忆文件

文档

• GitHub：https://github.com/clawdbot/clawdbot