这是一个基于Python开发、依托OpenAI API构建的Telegram机器人项目,核心功能是将ChatGPT集成到Telegram平台,同时扩展了多种实用特性。以下是项目的详细介绍:
一、核心功能
1. 基础交互能力
低延迟回复:通常35秒内生成响应,比网页版ChatGPT更快捷。
无每日请求限制:无需担心频繁使用被截断。
消息流式传输:回复内容会逐段发送到Telegram,无需等待完整内容生成。
多模型支持:兼容GPT4、GPT4 Turbo、GPT4 Vision(可处理图片),以及DALL·E 2(生成图片,需切换“👩🎨 Artist”模式)。
2. 扩展功能
语音消息识别:通过OpenAI Whisper API将语音转为文本,ChatGPT直接回复。
代码高亮:发送代码时自动格式化,便于阅读。
特殊聊天模式:内置15种预设角色(如“👩🏼🎓 English Tutor”“🧠 Psychologist”“🚀 Elon Musk”“📊 SQL Assistant”等),用户可通过编辑`config/chat_modes.yml`自定义新模式。
群聊支持:可在Telegram群中使用,输入`/help_group_chat`获取操作说明。
权限管理:支持设置“允许用户列表”,仅指定用户可使用机器人。
成本跟踪:能查看OpenAI API的消费余额(通过`/balance`命令)。
二、机器人命令
`/retry`:重新生成上一条回复。
`/new`:开启新对话(清除历史上下文)。
`/mode`:选择聊天模式(切换预设角色或功能)。
`/balance`:查看OpenAI API的剩余余额。
`/settings`:调整机器人配置(如模型选择)。
`/help`:查看帮助文档。
三、部署步骤
若要自行部署机器人,需完成以下操作:
1. 获取密钥:
从[OpenAI官网](https://openai.com/api/)申请API密钥。
从Telegram机器人`@BotFather`处获取机器人Token。
2. 配置文件:
将项目中的`config/config.example.yml`重命名为`config/config.yml`,并填入API密钥和Bot Token。
将`config/config.example.env`重命名为`config/config.env`(高级用户可修改此文件调整环境变量)。
3. 启动机器人:
运行以下Docker命令(需提前安装Docker):
“`bash
dockercompose envfile config/config.env up build
“`
四、其他信息
捐赠与贡献:项目收到过大额捐赠(如LilRocco捐赠11000美元),主要贡献者为`@karfly`和Jadve AI团队。
许可证:采用MIT开源许可证,允许自由修改和分发。
相关主题:项目标签包括`python`、`telegram`、`chatbot`、`openai`、`chatgpt`,适合Python开发者或ChatGPT爱好者参考。
该项目解决了网页版ChatGPT的延迟高、限制多等问题,同时通过Telegram的社交属性扩展了使用场景,是将AI模型落地到即时通讯工具的典型案例。
