DeepSeek Telegram 机器人
本仓库提供了一个基于 Golang 构建的 Telegram 机器人,集成了 DeepSeek API,实现 AI 驱动的智能回复功能。机器人支持 流式输出,让交互更加自然流畅。
English Documentation
🚀 功能特点
- 🤖 AI 智能回复:使用 DeepSeek API 进行智能对话。
- ⏳ 流式输出:实时发送回复,提升用户体验。
- 🎯 命令处理:支持自定义命令。
- 🏗 轻松部署:可在本地运行或部署到云服务器。
🤖 使用示例
📌 环境要求
📥 安装
-
克隆仓库
git clone https://github.com/yourusername/deepseek-telegram-bot.git cd deepseek-telegram-bot
-
安装依赖
go mod tidy
-
配置环境变量
export TELEGRAM_BOT_TOKEN="你的 Telegram 机器人 Token" export DEEPSEEK_TOKEN="你的 DeepSeek 授权 Token"
🚀 启动
本地运行:
go run main.go -telegram_bot_token=你的_telegram_token -deepseek_token=你的_deepseek_token
使用 Docker:
docker pull jackyin0822/telegram-deepseek-bot:latest
docker run -d -v /home/user/data:/app/data -e TELEGRAM_BOT_TOKEN="你的_telegram_token" -e DEEPSEEK_TOKEN="你的_deepseek_token" --name my-telegram-bot jackyin0822/telegram-deepseek-bot:latest
⚙️ 配置
通过环境变量配置机器人:
变量名 | 描述 | 默认值 |
---|---|---|
TELEGRAM_BOT_TOKEN (必填) | Telegram 机器人 Token | - |
DEEPSEEK_TOKEN (必填) | DeepSeek API Key / volcengine Api Key文档 | - |
CUSTOM_URL | 自定义 DeepSeek URL | api.deepseek.com/ |
DEEPSEEK_TYPE | DeepSeek 类型(deepseek-r1-250120,doubao-1.5-pro-32k-250115 等) | deepseek |
VOLC_AK | Volcengine 图像生成模型的 AK 文档 | - |
VOLC_SK | Volcengine 图像生成模型的 SK 文档 | - |
DB_TYPE | 数据库类型:sqlite3 / mysql | sqlite3 |
DB_CONF | 数据库配置:sqlite3 文件路径或 MySQL 连接信息 | ./data/telegram_bot.db |
ALLOWED_TELEGRAM_USER_IDS | 允许使用机器人的 Telegram 群聊 ID,多个群聊用逗号分隔,0表示所有用户可使用, 空表示所有群组都不能使用 | - |
ALLOWED_TELEGRAM_USER_IDS | 允许使用机器人的 Telegram 用户 ID,多个用户用逗号分隔,0表示所有用户可使用,空表示所有用户都不能使用 | - |
DEEPSEEK_PROXY | DeepSeek 代理 | - |
TELEGRAM_PROXY | Telegram 代理 | - |
CUSTOM_URL
如果使用自建的 DeepSeek 服务,可通过 CUSTOM_URL 指定自建服务的地址。
DEEPSEEK_TYPE
deepseek
: 使用官方 DeepSeek 服务,但稳定性可能波动。others
: 使用其他模型,例如 火山引擎。
DB_TYPE
支持 sqlite3 和 MySQL:
- sqlite3:配置为数据库文件路径,例如
./data/telegram_bot.db
- MySQL:配置为 MySQL 连接信息,数据库需提前创建,例如:
root:admin@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local
🛠️ 命令
/clear
清除与 DeepSeek 的所有对话记录,这些记录用于帮助 DeepSeek 理解上下文。
/retry
重试上一个问题。
/mode
选择 DeepSeek 模式,包括 chat
、coder
和 reasoner
。
chat
和 coder
对应 DeepSeek-V3
reasoner
对应 DeepSeek-R1
/balance
查询 DeepSeek 账户的余额。
/state
计算当前用户的 Token 使用量。
/photo
使用 Volcengine 图像生成模型创建图片,需配置 VOLC_AK 和 VOLC_SK。文档
/chat
在群组中使用 /chat
命令与机器人对话,无需将机器人设置为管理员。
/video
生成一个视频,DEEPSEEK_TOKEN
必须是 volcengine Api key. deepseek暂不支持生成视频. 文档
/help
查看帮助信息。
🚀 部署
使用 Docker 部署
-
构建 Docker 镜像
docker build -t deepseek-telegram-bot .
-
运行容器
docker run -d -v /home/user/xxx/data:/app/data -e TELEGRAM_BOT_TOKEN="你的_telegram_token" -e DEEPSEEK_TOKEN="你的_deepseek_token" --name my-telegram-bot telegram-deepseek-bot
🤝 贡献
欢迎提交 Issues 和 Pull Requests 来改进此机器人!🚀
📜 许可证
MIT License © 2025 jack yin