OneBot V11 与 Telegram 消息转发插件
📖 功能
- 互通模式：指定一个 QQ 群与一个 Telegram 群/频道双向互通，消息实时同步
- 转发模式：将 QQ 所有接收到的消息单向转发到 Telegram 私聊/频道/群聊
- 转发模式黑白名单，仅允许/除了名单内的群/qq号转发
- 使用指令临时关闭单向互通
- 互通模式和转发模式可同时开启不会重复发送消息
- Telegram 图片/贴纸下载会自动走适配器配置的代理
- 消息类型支持：文本、图片、贴纸
- 贴纸图片过大时自动压缩？
- GIF转发
- 显示具体表情而不是表情ID
- 显示@人的昵称而不是QQ号
- 双向转发Reply消息 这个可能需要做数据库
- 在实现Reply消息后 实现转发模式双向转发
...
💿 安装
使用 nb-cli 安装
在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装nb plugin install nonebot-plugin-onebot2tg --upgrade
使用 pypi 源安装
nb plugin install nonebot-plugin-onebot2tg --upgrade -i "https://pypi.org/simple"
使用清华源安装
nb plugin install nonebot-plugin-onebot2tg --upgrade -i "https://pypi.tuna.tsinghua.edu.cn/simple"
使用包管理器安装
在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令uv
uv add nonebot-plugin-onebot2tg
安装仓库 main 分支
uv add git+https://github.com/SoulGateKey/nonebot-plugin-onebot2tg@main
pdm
pdm add nonebot-plugin-onebot2tg
安装仓库 main 分支
pdm add git+https://github.com/SoulGateKey/nonebot-plugin-onebot2tg@main
poetry
poetry add nonebot-plugin-onebot2tg
安装仓库 main 分支
poetry add git+https://github.com/SoulGateKey/nonebot-plugin-onebot2tg@main
打开 nonebot2 项目根目录下的 pyproject.toml 文件, 在 [tool.nonebot] 部分追加写入
plugins = ["nonebot_plugin_onebot2tg"]
使用 nbr 安装(使用 uv 管理依赖可用)
nbr 是一个基于 uv 的 nb-cli，可以方便地管理 nonebot2
nbr plugin install nonebot-plugin-onebot2tg
使用 pypi 源安装
nbr plugin install nonebot-plugin-onebot2tg -i "https://pypi.org/simple"
使用清华源安装
nbr plugin install nonebot-plugin-onebot2tg -i "https://pypi.tuna.tsinghua.edu.cn/simple"
依赖适配器
- nonebot-adapter-onebot (OneBot V11)
- nonebot-adapter-telegram (Telegram)
⚙️ 配置
在 .env 文件中添加以下配置项：
模式开关
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
ONEBOT2TG_ENABLE_BRIDGE |
bool |
True |
开启互通模式（双向转发，需配置互通群号，默认开启） |
ONEBOT2TG_ENABLE_FORWARD |
bool |
False |
开启转发模式（QQ 所有消息单向转发到 TG） |
互通模式配置
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
ONEBOT2TG_BRIDGE_GROUP_ID |
str | int |
"" |
互通模式下，要互通的 QQ 群号 |
ONEBOT2TG_BRIDGE_TG_CHAT_ID |
str | int |
"" |
互通模式下，TG 对应的 chat_id（群或频道） |
互通模式指令表
| 指令 | 触发端 | 作用 |
|---|---|---|
| /ruler | Telegram | 临时关闭 TG → QQ 的互通转发 |
| /sese | 临时关闭 QQ → TG 的互通转发 |
转发模式配置
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
ONEBOT2TG_FORWARD_TARGET_CHAT_ID |
str | int |
"" |
转发模式下，QQ 消息转发到 TG 的目标 chat_id 或 用户ID |
onebot2tg_forward_filter_mode |
str |
"none" |
可选"none","blacklist","whitelist" |
onebot2tg_forward_filter_list |
list |
[] |
按照filter_mode的参数配置白名单或黑名单,如["12345678","123"] |
🎉 使用示例
场景 1：QQ 群与 Telegram 群互通
ONEBOT2TG_ENABLE_BRIDGE=true
ONEBOT2TG_ENABLE_FORWARD=false
ONEBOT2TG_BRIDGE_GROUP_ID=123456789
ONEBOT2TG_BRIDGE_TG_CHAT_ID=-1001234567890
配置后，该 QQ 群与 Telegram 群的消息会实时双向同步。
场景 2：QQ 消息单向转发到 Telegram
ONEBOT2TG_ENABLE_BRIDGE=false
ONEBOT2TG_ENABLE_FORWARD=true
ONEBOT2TG_FORWARD_TARGET_CHAT_ID=-1001234567890
配置后，QQ 群/私聊接收到的所有消息会单向转发到指定的 Telegram 聊天。
场景 3：互通和转发模式同时开启
注意事项
- 目前仅测试过QQ与TG互转，其他onebot实现欢迎提交测试结果及PR
- 互通模式为一对一配置，暂不支持多群互通
- 转发模式为单向（QQ → TG），TG 消息不会转发回 QQ
1 maintainer
Metadata
1 maintainer
Release files for nonebot-plugin-onebot2tg 1.0.12
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nonebot_plugin_onebot2tg-1.0.12.tar.gz | 8.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nonebot_plugin_onebot2tg-1.0.12-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 17.3 kB
Release files / nonebot_plugin_onebot2tg-1.0.12.tar.gz
| Download URL | nonebot_plugin_onebot2tg-1.0.12.tar.gz |
|---|---|
| Size | 8.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e306b05653859d69879e05ba9d9b0949477deb100c5f758a848ebf43242c2bfd
|
|
BLAKE2b-256 checksum How to use checksums |
7bf833451440af1cebf9d68d629e04918f8f2094334b7a8de732415a4e4aecfa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.16 {"installer":{"name":"uv","version":"0.12.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / nonebot_plugin_onebot2tg-1.0.12-py3-none-any.whl
| Download URL | nonebot_plugin_onebot2tg-1.0.12-py3-none-any.whl |
|---|---|
| Size | 8.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a8826a7b4722e4dcd5d0166a1a48167f56b046de069c55b983aecd30cf0ed3d4
|
|
BLAKE2b-256 checksum How to use checksums |
c6b8d7aabd6009467a89536343db07acedba2d86c642ab082ce2ec5b0998f093
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.16 {"installer":{"name":"uv","version":"0.12.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
