Alma Plugin: Alma Telegram Bridge

type

status

date

slug

summary

Alma Telegram Bridge

随时随地，掌控你与 Alma 的 AI 对话

一款将 Alma 与 Telegram 无缝连接的插件。

无论身在何处，都能通过 Telegram 实时接收回复、查看对话线程。

✨ 核心特性

功能	说明
🔄 双向同步	Alma 的回复实时推送到 Telegram，手机端即时响应
📑 线程管理	在 Telegram 中轻松浏览、切换和管理 Alma 对话列表
📜 历史回溯	支持分页查看历史消息，上下文一目了然
🎮 便捷交互	全面支持 Inline Keyboard 按钮，告别繁琐的命令输入
🔔 实时通知	即使不在电脑前，也能通过通知第一时间获取 AI 响应

📱 界面预览

主菜单

线程列表

消息浏览

🚀 快速开始

只需简单几步，即可开启你的与 Alma 消息同步的移动 AI 之旅。

1. 获取 Telegram Bot Token

在 Telegram 中搜索并联系 @BotFather。

发送 /newbot 创建一个新的机器人。

按照提示设置名称，最终你将获得一个 Bot Token。请保存好。

2. 获取你的 Chat ID

在 Telegram 中搜索 @userinfobot。

发送任意消息，机器人会立即回复你的 Chat ID。请保存好。

3. 安装及配置插件

打开 Alma 的设置页面，选择Plugins，点击+Install，输入Githu地址：https://github.com/moreoronce/alma-telegram-bridge

点击 Configuration 的设置Telegram对话的配置信息：

4. 启动体验

重启 Alma 以加载配置。

在 Telegram 中向你的 Bot 发送 /start。

如果看到欢迎菜单，说明连接成功！🎉

⚙️ 配置详解

设置项	类型	默认值	说明
`telegram-bridge.botToken`	`string`	-	必填，你的 Telegram Bot Token
`telegram-bridge.chatId`	`string`	-	必填，你的个人 Chat ID
`telegram-bridge.pollingInterval`	`number`	`2000`	消息轮询间隔（毫秒），越小越即时
`telegram-bridge.threadId`	`string`	-	指定默认绑定的 Alma 线程 ID（可选）

📖 常用命令

虽然我们推荐使用按钮交互，但也支持以下命令：

命令	作用
`/start`	启动机器人并显示主菜单
`/menu`	重新呼出主菜单
`/ping`	测试与服务器的连接延迟

🎯 适用场景

🚌 通勤路上：利用碎片时间回顾或继续对话。

🛌 离开电脑：躺在沙发上也能轻松控制 Alma。

🔔 任务监控：让 Alma 在后台运行任务，完成后通过 Telegram 通知你。

🔧 技术细节

基于 Telegram Bot API (Long Polling) 实现，无需公网 IP，也无需服务器中转。

智能解析 Alma 复杂消息结构（支持 Parts 数组）。根据Telegram能力，可解析部分markdown格式。

自动处理长消息截断，完美适配 Telegram 消息长度限制。

🤗 总结归纳

feat(telegram-bridge): 修复消息格式化和分页功能

改用 HTML 格式替代 MarkdownV2，修复格式渲染问题

修复翻页在第4-5页卡住的 bug (缩短 callback_data)

新增 Debug 按钮显示插件状态

优化分页按钮布局和错误处理

📎 参考文章

https://alma.now/docs/plugins/

https://github.com/moreoronce/alma-telegram-bridge