MiraiForum

    • Register
    • Login
    • Search
    • Popular
    • Recent
    • Unsolved
    • Tags
    • Groups
    • 友情链接

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

    其他项目发布
    telegram java
    3
    3
    456
    Loading More Posts
    • Oldest to Newest
    • Newest to Oldest
    • Most Votes
    Reply
    • Reply as topic
    Log in to reply
    This topic has been deleted. Only users with topic management privileges can see it.
    • Travellerr
      Travellerr last edited by Travellerr

      Tele-KiraLink



      基于 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不支持


      实现效果

      ac8ba97a-2c8f-4d9c-8610-fcd0d6d4f2a6-image.png
      108a20c6-32e2-4601-a872-50ed17cc55df-QQ_1744449911186.png

      1 Reply Last reply Reply Quote 2
      • mckyby
        mckyby 摸鱼 last edited by

        我勒个去这都行?

        1 Reply Last reply Reply Quote 0
        • KJZH001
          KJZH001 童心未泯 last edited by

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

          1 Reply Last reply Reply Quote 0
          • 1 / 1
          • First post
            Last post
          Powered by Mamoe Technologies & NodeBB | 友情链接 | 服务监控 | Contact