Clawdbot 安装教程：Debian 服务器 + Google Antigravity + Telegram 完整指南【2026最新】

Clawdbot 是一款强大的 AI 助手框架，可以让你在 Telegram、WhatsApp 等平台上与 AI 进行对话。本教程将详细介绍如何在 Debian 服务器上安装 Clawdbot，并配置 Google Antigravity（通过 OAuth 认证）和 Telegram 接入。

环境要求

• Debian 11/12 或 Ubuntu 20.04+ 服务器
• Node.js 20+ (推荐使用 Node.js 22)
• npm 或 pnpm 包管理器
• Google 账号（用于 OAuth 认证）
• Telegram Bot Token

第一步：安装 Node.js

首先更新系统并安装 Node.js：

# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装 curl（如果没有）
sudo apt install -y curl

# 使用 NodeSource 安装 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 验证安装
node --version  # 应显示 v22.x.x
npm --version

第二步：安装 Clawdbot

使用 npm 全局安装 Clawdbot：

# 全局安装 Clawdbot
sudo npm install -g clawdbot

# 验证安装
clawdbot --version

第三步：配置 Google Antigravity OAuth 认证

Google Antigravity 使用 OAuth 认证，无需手动获取 API Key。按以下步骤配置：

方式一：交互式配置（推荐）

clawdbot configure --section provider

选择 google-antigravity 作为提供商，然后按照提示完成 OAuth 认证流程：

1. 系统会显示一个授权 URL
2. 在浏览器中打开该 URL
3. 使用你的 Google 账号登录并授权
4. 授权完成后，认证信息会自动保存

方式二：命令行认证

# 启动 OAuth 认证流程
clawdbot auth google-antigravity

按照终端提示完成认证。

方式三：手动配置

如果你已有 OAuth 凭证，可以手动创建配置文件 ~/.clawdbot/config.json：

{
  "provider": "google-antigravity",
  "model": "google-antigravity/claude-opus-4-5-thinking",
  "googleAntigravity": {
    "oauth": true
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "你的 Telegram Bot Token",
      "allowedUsers": ["你的 Telegram 用户名或ID"]
    }
  }
}

OAuth 认证说明

• OAuth 认证比 API Key 更安全，无需在配置文件中存储密钥
• 认证令牌会自动刷新，无需手动维护
• 首次认证需要浏览器访问授权页面
• 在无图形界面的服务器上，可以复制 URL 到本地浏览器完成授权

第四步：创建 Telegram Bot

1. 在 Telegram 中搜索 @BotFather
2. 发送 /newbot 命令
3. 按提示设置 Bot 名称和用户名
4. 复制获得的 Bot Token（格式如：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

第五步：配置 Telegram

运行 Telegram 配置向导：

clawdbot configure --section telegram

输入 Bot Token 和允许使用的用户名/ID。

配置说明

• provider: 设置为 google-antigravity 使用 Google Antigravity 模型
• model: 可选模型包括 google-antigravity/claude-opus-4-5-thinking（推荐）、google-antigravity/claude-sonnet-4 等
• allowedUsers: 设置允许使用 Bot 的用户，可以是用户名或用户 ID

第六步：启动 Clawdbot

有多种启动方式：

方式一：前台运行（测试用）

clawdbot gateway start --foreground

方式二：后台运行

clawdbot gateway start

方式三：使用 systemd 服务（推荐生产环境）

创建 systemd 服务文件 /etc/systemd/system/clawdbot.service：

[Unit]
Description=Clawdbot AI Assistant
After=network.target

[Service]
Type=simple
User=root
ExecStart=/usr/bin/clawdbot gateway start --foreground
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

启用并启动服务：

sudo systemctl daemon-reload
sudo systemctl enable clawdbot
sudo systemctl start clawdbot
sudo systemctl status clawdbot

第七步：测试 Bot

打开 Telegram，找到你创建的 Bot，发送任意消息测试是否正常响应。

常用命令速查

可选功能配置

启用 TTS（文字转语音）

clawdbot configure --section tts

配置工作目录

Clawdbot 默认使用 ~/.clawdbot/work 作为工作目录，你可以在配置中修改：

{
  "workspace": "/path/to/your/workspace"
}

故障排除

• Bot 无响应：检查 Token 是否正确，确认 allowedUsers 配置是否包含你的用户名/ID
• OAuth 认证失败：运行 clawdbot auth google-antigravity 重新认证
• 令牌过期：OAuth 令牌通常会自动刷新，如遇问题可重新认证
• 查看日志：运行 clawdbot gateway logs 或 journalctl -u clawdbot -f
• 权限问题：确保 Node.js 和 Clawdbot 有正确的执行权限

进阶配置

Clawdbot 还支持更多高级功能：

• 多渠道支持：同时接入 WhatsApp、Discord、Slack 等
• 定时任务：使用 cron 功能设置定时提醒和自动化任务
• 浏览器控制：通过浏览器扩展实现网页操作
• 文件管理：读写服务器文件、执行命令
• Thinking 模式：启用深度推理，适合复杂任务

总结

恭喜！你已经成功在 Debian 服务器上部署了 Clawdbot，并通过 OAuth 认证配置了 Google Antigravity 模型和 Telegram。相比传统的 API Key 方式，OAuth 认证更加安全便捷。现在你可以通过 Telegram 与 AI 助手进行对话、执行命令、管理文件等操作。

更多信息请访问：

• Clawdbot 官方文档
• GitHub 仓库
• Discord 社区