人工智能

随时随地调遣服务器 Agent：基于 Telegram Bot 深度操控 Antigravity CLI 实战指南

6 min read
随时随地调遣服务器 Agent：基于 Telegram Bot 深度操控 Antigravity CLI 实战指南

在传统的远程开发场景中，如果我们出门在外突发灵感、需要紧急在服务器上排查 Bug、或者想让 AI 对某段开源代码进行重构分析，通常需要掏出笔记本、打开 SSH 终端或连接 VPN。但设想这样一个场景：只需在手机 Telegram 中发送一条消息或上传一个代码文件，云端部署的 Google Antigravity Agent 便会立即在服务器上执行分析、修改代码、运行测试并将结果实时回传给您。 本文将带您深度拆解如何构建这样一套全能型 Telegram 控制终端架构。

01. 架构拓扑：轻量且高内聚的设计哲学

为了兼顾极简部署与强大的工程能力，整体系统采用 长轮询（Long Polling）+ 进程级 SOCKS5 代理隔离 + 异步非阻塞子进程桥接 的技术拓扑：

┌─────────────────────────────────────────────────────────────┐
│                 Telegram Client (手机 / PC 端)               │
└──────────────────────────────┬──────────────────────────────┘
                               │ HTTPS (经过 MTProto 加密)
                               ▼
┌─────────────────────────────────────────────────────────────┐
│              VPS 本地 SOCKS5 代理 (127.0.0.1:1080)            │
└──────────────────────────────┬──────────────────────────────┘
                               │ 仅供 Bot 进程走代理
                               ▼
┌─────────────────────────────────────────────────────────────┐
│       Python 异步核心服务 (Antigravity Telegram Bot)         │
│   • 安全白名单拦截 (ALLOWED_USER_IDS)                        │
│   • 会话状态管理 (ChatSession & Brain 跟踪)                  │
│   • 智能 Markdown 分段与代码块保护算法                      │
│   • 实时云端配额监控与北京时间倒计时解析                     │
└──────────────────────────────┬──────────────────────────────┘
                               │ asyncio.create_subprocess_exec
                               ▼
┌─────────────────────────────────────────────────────────────┐
│       Google Antigravity CLI (/home/ubuntu/.local/bin/agy)  │
│   • Gemini 3.7 / Claude 4.6 / GPT-OSS 多模型切换            │
│   • 代码读写、终端 Shell 执行、文件生成与提取               │
└─────────────────────────────────────────────────────────────┘

核心架构亮点：

  1. 免公网暴露与免域名：采用 Telegram 长轮询模式，服务器无需开放任何额外外部入站端口，亦无需绑定域名与申请 SSL 证书。
  2. 零系统污染：SOCKS5 代理仅注入到 Python Bot 及其衍生的 agy 子进程中，系统底层的 apt、nginx 与数据库均不受任何代理干扰。
  3. 安全白名单兜底：严格校验 Telegram 发送者的 user_id，未授权用户无法触发任何 Agent 指令或 Shell 脚本。

02. 关键核心能力与工程落地拆解

1. 多轮上下文跟踪与历史无缝恢复 (Session & Resume)

Antigravity 会话在本地以 UUID 记录存储于 ~/.gemini/antigravity-cli/brain/ 目录。Bot 会自动维护 Telegram 聊天 ID 与 Antigravity 会话 ID 的映射：

  • 发送文字直接进行自然多轮对话；
  • 发送 /new：立即封存当前话题，重置为全新会话；
  • 发送 /history：智能扫描最近会话的 transcript.jsonl 提取用户第一条 Prompt 摘要，并渲染为交互式 Inline Keyboard；
  • 发送 /resume <ID>：一键切回过去的任意任务现场继续工作。

2. Telegram 4096 字符限制下的智能分块器 (Smart Chunking)

AI 生成的代码往往非常长，极易超出 Telegram 单条消息 4096 字符的硬限制。若粗暴截断，会导致 Markdown 代码块 ``` 标签不闭合而引发排版崩坏。

我们设计了代码边界感知切分算法：智能检测代码块状态并在跨消息切分时自动闭合上一条消息的代码块并在下一条消息头部重新开启语言高亮标签，同时在发生 Telegram Markdown 实体解析异常时自动平滑回退至纯文本，确保 100% 可读性。

3. 双向文件交互与产物提取 (/get 与 Document Handler)

  • 手机上传即分析：在 Telegram 中发送任何 .py、.json、.log 文件，Bot 自动下载至服务器工作目录并喂给 Agent 进行代码审计与重构。
  • 产物直接取回：执行 /get dist/app.zip 或 /get main.py，服务器即刻将生成好的文件作为附件直接通过 Telegram 发回您的手机。

4. 实时云端配额与 5 小时/周度重置倒计时监控 (Quota / Usage)

Antigravity 拥有 5 小时滑动窗口额度 与 每周总配额 机制。Bot 深度集成了官方 /usage 接口，并自动计算北京时间（CST）与精准倒计时：

📊 Google Antigravity 账号模型调用额度看板

🔷 Gemini 系列模型 (Flash / Pro)
• ⏳ 5 小时滑动额度: 85% 剩余 (重置: 08-17 02:30 [约 3小时30分后])
• 📅 每周总调用额度: 90% 剩余 (重置: 08-18 02:36 [约 1天3小时后])

🟣 Claude & GPT 系列模型 (Sonnet / Opus / GPT-OSS)
• ⏳ 5 小时滑动额度: 100% 剩余 (重置: 08-17 03:56 [约 4小时55分后])
• 📅 每周总调用额度: 100% 剩余 (重置: 08-23 22:56 [约 6天23小时后])

—
💬 当前会话 Token 消耗:
• 🪙 会话 Token: 15,415 tokens | 🚀 历史总请求: 12 次
• 🤖 当前活动模型: gemini-3.7-flash-high | 🧠 思考深度: high

03. 生产级守护与开机自启动配置 (Systemd)

为了保证 Bot 全天候 7×24 小时稳定运行且遇崩溃自愈，我们将其封装为标准的 systemd 服务：

[Unit]
Description=Antigravity CLI Telegram Bot Service
After=network.target network-online.target
Wants=network-online.target

[Service]
Type=simple
User=ubuntu
WorkingDirectory=/home/ubuntu/antigravity-telegram-bot
Environment="PATH=/home/ubuntu/antigravity-telegram-bot/venv/bin:/home/ubuntu/.local/bin:/usr/local/bin:/usr/bin:/bin"
Environment="http_proxy=socks5://127.0.0.1:1080"
Environment="https_proxy=socks5://127.0.0.1:1080"
Environment="all_proxy=socks5://127.0.0.1:1080"
ExecStart=/home/ubuntu/antigravity-telegram-bot/venv/bin/python3 /home/ubuntu/antigravity-telegram-bot/bot.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

# 一键启用与守护
sudo systemctl daemon-reload
sudo systemctl enable antigravity-bot
sudo systemctl start antigravity-bot

04. Telegram 常用快捷指令速查手册

在 Telegram 聊天输入框输入 / 即可呼出原生快捷菜单：

指令 功能说明 实战示例
/usage 或 /quota 实时查询 5小时滑动限额、周额度与重置倒计时 /usage
/model 一键切换底层 AI 模型 (Gemini / Claude / GPT) /model claude-sonnet-4-6
/effort 调节深度思考级别 (low / medium / high) /effort high
/history 交互式浏览历史会话并一键恢复现场 /history
/delete 彻底删除指定历史会话并释放服务器空间 /delete latest
/cwd 查看或切换 Agent 当前服务器工作空间 /cwd /home/ubuntu/my-project
/ls 查看当前工作目录下的文件列表 /ls src
/get 从服务器下载代码/压缩包发回手机 /get report.md
/git 查看工作区 Git 状态与代码变更对比 /git diff
/stop 紧急中断正在进行的耗时生成任务 /stop
/cmd 执行单条 Linux Shell 命令并回传输出 /cmd free -h

05. 总结

通过将 Google Antigravity CLI 与 Telegram Bot 的深度融合，我们打破了传统 AI 编程助手必须依托本地大屏桌面环境的物理限制。无论是在通勤路上、差旅途中还是床上休息时，随手打开手机 Telegram，即可调度云端最顶级的 Agent 算力，真正实现了「随时随地，口袋里的云端编程副驾驶」。

#人工智能 #Linux与运维 #开发工具与排错