TeleOA - 一个基于 OneBot v11 标准的 Telegram机器人Java实现

Travellerr

Telegram-Onebot-Adapter

基于 OneBot 的 Telegram机器人OneBot v11 Java实现端，可以将mirai无缝迁移至Telegram使用

写的不好，请多指教

底层

Java Telegram Bot API: Telegram Bot API的Java实现

兼容性

完全兼容Onebot-v11协议,可与Onebot-v11协议的框架相连接,实现大部分功能

使用SpringBoot框架,可直接打包为jar文件在Jdk17环境下运行

提供OneBot-v11正向Websocket方式连接该项目。

TeleOA支持以下连接方式:

纯http轮询 getmsg获取信息
webhook获取 (to-do)

支持连接 Mirai-Overflow

其他项目暂未测试

理论上可以与支持OneBotV11适配器的项目相连接使用

内置网页控制面板，ip为onebot配置ip端口根页面

使用方法

请确保设备环境安装了JDK17，否则将无法正常运行

前往 TeleOA Release 下载最新版本的jar文件

将项目主体放置在任意目录中，确保文件夹中没有其他文件

使用以下命令启动项目

java -jar Telegram-Onebot-Adapter-[version].jar

如果是第一次启动，项目将自动生成配置文件，请根据需要修改配置文件

修改配置后，重新启动项目

配置指南

该项目目前仅支持数组格式消息转发/接收,请确保你的框架支持该格式

后续会逐渐适配其他格式,若有问题请移步issue提出

支持proxy代理(HTTP(未测试)/SOCKS 账密),若有需要请在config.yml中配置

下方的需配置均为config.yml的配置项,配置项右侧有注释解释和格式例子

command:
  commandMap:
    start: 开始
    help: 帮助
    [Telegram发送内容]: [转发至Onebot内容]
  prefix: [指令前缀 默认为"/"]
onebot:
  ip: 0.0.0.0
  path: [Onebot ws连接路径]
  port: [Onebot ws连接端口]
  useArray: [是否启用Array消息 true/false]
spring:
  database:
    dataType: [数据库类型, H2/SQLITE/MYSQL]
    mysqlPassword: [数据库密码, 若使用H2/SQLITE可不填]
    mysqlUrl: [数据库连接url, 若使用H2/SQLITE可不填]
    mysqlUser: [数据库用户名, 若使用H2/SQLITE可不填]
  webui:
    password: [网页面板密码]
    userName: [网页面板用户名]
telegram:
  bot:
    proxy:
      host: [代理IP地址，不建议纯域名]
      port: [代理端口]
      secret: [代理密码]
      type: [HTTP/SOCKS/DIRECT]
      username: [代理账号]
    token: [你的bot token]
    username: [你的bot 用户名，随意设置]

功能

HTTP API
反向 HTTP POST
正向 WebSocket
反向 WebSocket
连接多个ws地址
网页控制台
后台操作收发消息
代理支持
Telegram聊天信息区分用户和群组

实现

注意

下列表格中的✅表示已实现,❌表示未实现,✅❓表示已实现但未测试

已实现 API

符合 OneBot 标准的 API

API	功能	实现情况
`/send_private_msg`	[发送私聊消息]	✅
`/send_group_msg`	[发送群消息]	✅
`/send_msg`	[发送消息]	✅
`/delete_msg`	[撤回信息]	✅
`/set_group_kick`	[群组踢人]	✅❓
`/set_group_ban`	[群组单人禁言]	✅
`/set_group_whole_ban`	[群组全员禁言]	❌
`/set_group_admin`	[群组设置管理员]	✅
`/set_group_card`	[设置群名片（群备注）]	✅❓
`/set_group_name`	[设置群名]	✅❓
`/set_group_leave`	[退出群组]	✅❓
`/set_group_special_title`	[设置群组专属头衔]	✅
`/set_friend_add_request`	[处理加好友请求]	❌
`/set_group_add_request`	[处理加群请求/邀请]	❌
`/get_login_info`	[获取登录号信息]	✅
`/get_stranger_info`	[获取陌生人信息]	❌
`/get_friend_list`	[获取好友列表]	✅
`/get_group_info`	[获取群信息]	✅
`/get_group_list`	[获取群列表]	✅
`/get_group_member_info`	[获取群成员信息]	✅
`/get_group_member_list`	[获取群成员列表]	✅
`/get_group_honor_info`	[获取群荣誉信息]	❌
`/can_send_image`	[检查是否可以发送图片]	❌
`/can_send_record`	[检查是否可以发送语音]	❌
`/get_version_info`	[获取版本信息]	✅
`/set_restart`	[重启TOA]	❌
`/get_image`	[获取图片信息]	❌
`/get_msg`	[获取消息]	✅
`/get_status`	[获取状态]	✅

已实现 Event

符合 OneBot 标准的事件

事件类型	事件描述	实现情况
消息事件	[私聊信息]	✅
消息事件	[群消息]	✅
通知事件	[群文件上传]	❌
通知事件	[群管理员变动]	❌
通知事件	[群成员减少]	❌
通知事件	[群成员增加]	❌
通知事件	[群禁言]	❌
通知事件	[群消息撤回]	❌
通知事件	[好友消息撤回]	❌
请求事件	[加好友请求]	❌
请求事件	[加群请求/邀请]	❌

已实现 Message

消息类型	收情况	发情况
纯文本	✅	✅
图片	✅	✅
图文混合(图片描述)	✅	✅
语音	❌	❌
短视频	❌	❌
at某人	✅	✅
回复	✅	✅

其余MessageTelegram不支持

实现效果

108a20c6-32e2-4601-a872-50ed17cc55df-QQ_1744449911186.png

mckyby

我勒个去这都行？

KJZH001

我勒个去这都行？
既然都是onebot了，那我猜测丢给matrix或许也能跑？