项目简介
如果你在使用 Google Antigravity CLI(agy)时,经常需要在终端中反复确认或不方便持续操作,可以看看这个项目:
agy-telegram-remote 将 agy 接入 Telegram 私聊。你可以在手机上向机器人发送任务,由 VPS 上的 agy 执行,并将处理结果返回到 Telegram。它的定位是一个面向个人使用的远程操作入口,不修改 agy 本身。
项目地址:
https://github.com/shixiaoheia/agy-telegram-remote
主要功能
- 通过 Telegram 私聊提交代码阅读、修改和问题排查任务
- 使用
/model 选择模型及思考强度
- 执行过程中显示任务状态、已完成步骤和耗时摘要
- 支持取消正在执行的任务
- 支持发送截图、日志以及常见代码和文本文件进行分析
- 使用
/history 查看最近任务记录,使用 /status 查看运行状态
- 任务结束后返回状态、回复内容和运行统计
安装方式
目前支持 Debian 12+ 或 Ubuntu 22.04+,并需要能够使用 root 登录 VPS。登录服务器后执行:
curl -fsSL https://raw.githubusercontent.com/shixiaoheia/agy-telegram-remote/main/install.sh -o install.sh && bash install.sh --root
安装脚本会引导配置 Telegram Bot Token、允许使用机器人的 Telegram 数字 ID,以及首次使用时的 Google agy 授权。安装完成后,在 Telegram 中发送 /start,再发送 /model 选择模型。
使用场景
- 外出时临时查看或修改服务器上的项目
- 通过手机发送日志、代码文件,让 AI 协助定位问题
- 对个人 VPS 进行日常维护和任务排查
安全说明
这个项目会让 AI 在 VPS 工作目录中执行任务,请只在自己或完全信任的环境中使用:
- Bot Token、Google 授权信息、密码和私钥不要发送到聊天记录或公开仓库
- 白名单只配置自己的 Telegram 数字 ID
- AI 生成或执行的结果需要人工复核,尤其是涉及文件删除、服务重启和生产配置的操作
- 发送给机器人的附件会用于当前任务处理,请注意文件中是否包含敏感信息
欢迎大家提出使用建议,也欢迎检查项目的实现方式和安全设计。
致谢
感谢 Google Antigravity CLI(agy)及相关开源项目和社区提供的思路与基础能力,也感谢各位试用、反馈和提出改进建议的朋友。
如果项目对你有帮助
欢迎在 GitHub 点个 Star,Star 是对项目持续维护最直接的支持:
https://github.com/shixiaoheia/agy-telegram-remote
Telegram 交流
欢迎加入我的 Telegram 群组,交流项目使用体验、部署问题和相关技术话题:
https://t.me/xiaoheidemimi
欢迎各位交流。
彩蛋:你猜为什么我要在github上面加上搬瓦工的aff链接?
答:aff真高(狗头)