Telegram 桥接 #

基于 mautrix-telegram。把你参与的每一个 Telegram 聊天都映射为一个 Matrix 房间，支持完整的傀儡模式——你从 Matrix 发出的消息在 Telegram 那边看起来就像是你本人原生发的。

前置条件 #

  • Meldry 套餐： Pro 或 Business（Telegram 占用一个桥接配额）
  • 一个带手机号的 Telegram 账户（Telegram API 要求必填，无法绕过）
  • 你的 Telegram 手机号，用来接收登录验证码
  • 可选： 从 @BotFather 获取的 bot token，如果你还想给未关联的 Matrix 用户提供中继模式

启用桥接 #

  1. 打开 Meldry 仪表板。
  2. 进入 服务器 → 桥接。
  3. 找到 Telegram，点 启用。
  4. 等大约 10 秒让桥接容器启动。该行会变成绿色。

桥接现在会在 @telegrambot:<你的名称>.meldry.com 运行一个机器人用户。

关联 Telegram 账户 #

  1. 在 Matrix 客户端里，与 @telegrambot:<你的名称>.meldry.com 开一条新的私聊。
  2. 发送 login。
  3. 机器人会问你的 手机号——用国际格式回复（例如 +8613912345678）。
  4. Telegram 会把验证码发到你现有的 Telegram 客户端（手机、桌面）。用 code 12345 格式在私聊里回复。
  5. 如果你的 Telegram 账户启用了二级密码（2FA），机器人接着会问 2FA 密码——用 password 你的密码 回复。
  6. 你会看到 Successfully logged in as @yourhandle。

此后，你参与的每个 Telegram 聊天——1 对 1 DM、群组、订阅的频道——都会作为 Matrix 房间出现在你的客户端里，统一归组到一个 Telegram 空间下。

首次运行提示 #

  • 历史回填。 桥接在首次运行时会拉取每个聊天最近约 50 条消息。大群组可能要一分钟。
  • 联系人。 你的 Telegram 联系人会以 @telegram_<id>:<你的名称>.meldry.com 这种 Matrix 用户形式出现。他们的显示名会同步 Telegram 上的名字。
  • 头像。 Telegram 头像会自动同步为 Matrix 头像。改动会在几秒内生效。

发送消息 #

直接在任意桥接房间里打字，桥接会实时转发到 Telegram。

  • 文本、Markdown、@、回复、表情反应——全部双向同步。
  • 编辑与删除——也是双向的。在 Matrix 里编辑一条消息，1 秒内就会在 Telegram 侧更新。
  • 媒体——图片、视频、音频、文件都支持，上限是 Telegram 的 2 GB。
  • 贴纸——Telegram 贴纸会以 Matrix 图片形式显示。从 Matrix 发贴纸到 Telegram 需要桥接配置贴纸包（默认已启用）。
  • 语音消息——双向支持。
  • 投票——只能从 Matrix 读取 Telegram 投票，创建投票必须回到 Telegram。

发起新聊天 #

如果你想给一个还没建房间的 Telegram 联系人发私聊，给桥接机器人发送：

pm @telegram_handle

一个新的 Matrix 房间会出现，里面是那个联系人的傀儡。

如果要通过邀请链接加入一个 Telegram 群组：

join https://t.me/joinchat/XYZ

命令列表 #

所有命令都在与 @telegrambot:<你的名称>.meldry.com 的私聊里发送：

命令作用
login / login-bot关联个人账户 / bot token
logout解绑 Telegram 账户（删除傀儡会话）
status查看当前登录状态
pm @handle打开与某个 Telegram 用户的 DM
join <link>通过邀请链接加入 Telegram 群
sync强制重新同步聊天
help完整命令列表

限制 #

  • 语音/视频通话 不桥接——Telegram 用的是桥接无法交互的私有协议。
  • 密聊（Telegram 自己的 E2EE 聊天） 按设计不桥接。
  • Premium 功能（更大文件上传、emoji 状态等）仅当你关联的 Telegram 账户是 Premium 时才能用。
  • 会话数限制。 Telegram 对每个账户的并发会话数有限制，桥接登录会占用一个会话。

故障排查 #

"Phone number invalid"——必须用国际格式，+ 开头加国家代码，不要有空格或连字符。

"Confirmation code expired"——验证码大约一分钟失效。重新发 login 获取新的。

"Session ended on another device"——Telegram 上的新登录（手机、桌面）可能会踢掉桥接的会话。重新运行 login。

消息延迟或乱序——通常意味着桥接从重启后正在追赶。等 30 秒自愈即可。

Telegram 侧的表情回应显示为 [BridgeBot reacted ❤]——说明你的傀儡没有认证。先 status 看报错；如果傀儡被禁用了，从桥接机器人私聊里重新 login。

解除关联 #

想断开时：给 @telegrambot:<你的名称>.meldry.com 发送 logout。桥接会解绑账户并停止镜像聊天。之后可再次关联。

要完全卸载桥接（释放一个桥接配额），在 仪表板 → 服务器 → 桥接 里禁用它。

下一步 #