https://github.com/yincongcyincong/musebot
supports Telegram, Discord, Slack, Lark（飞书），钉钉, 企业微信, QQ, 微信, compatible with various LLMs including OpenAI, Gemini, DeepSeek, Doubao, and OpenRouter. It offers intelligent conversation, image generation, video creation, and more. Works seamlessly in both private chats and group settings.
https://github.com/yincongcyincong/musebot
ai-bot deepseek discord feishu gemini openai openrouter slack telegram wechat
Last synced: 6 days ago
JSON representation
supports Telegram, Discord, Slack, Lark（飞书），钉钉, 企业微信, QQ, 微信, compatible with various LLMs including OpenAI, Gemini, DeepSeek, Doubao, and OpenRouter. It offers intelligent conversation, image generation, video creation, and more. Works seamlessly in both private chats and group settings.
- Host: GitHub
- URL: https://github.com/yincongcyincong/musebot
- Owner: yincongcyincong
- License: mit
- Created: 2025-02-17T10:58:11.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-10-24T07:16:31.000Z (9 days ago)
- Last Synced: 2025-10-24T09:13:32.947Z (9 days ago)
- Topics: ai-bot, deepseek, discord, feishu, gemini, openai, openrouter, slack, telegram, wechat
- Language: Go
- Homepage: https://github.com/yincongcyincong/MuseBot
- Size: 75.3 MB
- Stars: 789
- Watchers: 48
- Forks: 107
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: Changelog
- License: LICENSE
Awesome Lists containing this project
- awesome-ChatGPT-repositories - MuseBot - AI chatbot that supports both Telegram, Discord, Slack, Lark, Work Wechat, compatible with various LLMs including OpenAI, Gemini, DeepSeek, Doubao, and OpenRouter. It offers intelligent conversation, image generation, video creation, and more. Works seamlessly in both private chats and group settings. (Chatbots)
README
## group
telegram-group: https://t.me/+WtaMcDpaMOlhZTE1 , or you can have a try robot `Guanwushan_bot`.
every body have **10000** token to try this bot, please give me a star!
QQ群：1031411708
# MuseBot
This repository provides a **Chat bot** (Telegram, Discord, Slack, Lark（飞书），钉钉, 企业微信, QQ, 微信) that integrates
with **LLM API** to provide
AI-powered responses. The bot supports **openai** **deepseek** **gemini** **openrouter** LLMs, making interactions feel
more natural and dynamic.
[中文文档](https://github.com/yincongcyincong/MuseBot/blob/main/README_ZH.md)
[Китайская документация](https://github.com/yincongcyincong/MuseBot/blob/main/README_RU.md)
## Usage Video
easiest way to use: https://www.youtube.com/watch?v=4UHoKRMfNZg
deepseek: https://www.youtube.com/watch?v=kPtNdLjKVn0
gemini: https://www.youtube.com/watch?v=7mV9RYvdE6I
chatgpt: https://www.youtube.com/watch?v=G_DZYMvd5Ug
## 🚀 Features
- 🤖 **AI Responses**: Uses LLM API for chatbot replies.
- ⏳ **Streaming Output**: Sends responses in real-time to improve user experience.
- 🏗 **Easy Deployment**: Run locally or deploy to a cloud server.
- 👀 **Identify Image**: use image to communicate with LLM,
see [doc](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/imageconf.md).
- 🎺 **Support Voice**: use voice to communicate with LLM,
see [doc](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/audioconf.md).
- 🐂 **Function Call**: transform mcp protocol to function call,
see [doc](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/functioncall.md).
- 🌊 **RAG**: Support Rag to fill context,
see [doc](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/rag.md).
- 🌞 **AdminPlatform**: Use platform to manage MuseBot,
see [doc](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/admin.md).
- 🌛 **Register**: With the service registration module, robot instances can be automatically registered to the
registration center [doc](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/register.md)
- 🌈 **Metrics**: Support Metrics for monitoring,
see [doc](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/metrics.md).
## 📸 Support Platform
| Platform | Supported | Description | Docs / Links |
|----------------------|:---------:|-----------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------|
| 🟦 **Telegram** | ✅ | Supports Telegram bot (go-telegram-bot-api based, handles commands, inline buttons, ForceReply, etc.) | [Docs](https://github.com/yincongcyincong/MuseBot) |
| 🌈 **Discord** | ✅ | Supports Discord bot | [Docs](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/discord.md) |
| 🌛 **Web API** | ✅ | Provides HTTP/Web API for interacting with LLM (great for custom frontends/backends) | [Docs](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/web_api.md) |
| 🔷 **Slack** | ✅ | Supports Slack (Socket Mode / Events API / Block Kit interactions) | [Docs](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/slack.md) |
| 🟣 **Lark (Feishu)** | ✅ | Supports Lark long connection & message handling (based on larksuite SDK, with image/audio download & message update) | [Docs](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/lark.md) |
| 🆙 **DingDing** | ✅ | Supports Dingding long connection | [Docs](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/dingding.md) |
| ⚡️ **Work WeChat** | ✅ | Support Work WeChat http callback to trigger LLM | [Docs](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/com_wechat.md) |
| 🌞 **QQ** | ✅ | Support QQ http callback to trigger LLM | [Docs](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/qq.md) |
| 🚇 **Wechat** | ✅ | Support Wechat http callback to trigger LLM | [Docs](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/wechat.md) |
## Supported Large Language Models
| Model | Provider | Text Generation | Image Generation | Video Generation | Recognize Photo | TTS | Link |
|---------------------|--------------|-----------------|:----------------:|:----------------:|----------------:|----:|---------------------------------------------------------------------------------------------------------------|
| 🌟 **Gemini** | Google | ✅ | ✅ | ✅ | ✅ | ✅ | [doc](https://gemini.google.com/app) |
| 💬 **ChatGPT** | OpenAI | ✅ | ✅ | ❌ | ✅ | ✅ | [doc](https://chat.openai.com) |
| 🐦 **Doubao** | ByteDance | ✅ | ✅ | ✅ | ✅ | ✅ | [doc](https://www.volcengine.com/) |
| 🐦 **Qwen** | Aliyun | ✅ | ✅ | ✅ | ✅ | ✅ | [doc](https://bailian.console.aliyun.com/?spm=5176.12818093_47.overview_recent.1.663b2cc9wXXcVC&tab=api#/api) |
| 🧠 **DeepSeek** | DeepSeek | ✅ | ❌ | ❌ | ❌ | ❌ | [doc](https://www.deepseek.com/) |
| ⚙️ **302.AI** | 302.AI | ✅ | ✅ | ✅ | ✅ | ❌ | [doc](https://302.ai/) |
| 🌐 **OpenRouter** | OpenRouter | ✅ | ✅ | ❌ | ✅ | ❌ | [doc](https://openrouter.ai/) |
| 🌐 **ChatAnywhere** | ChatAnywhere | ✅ | ✅ | ❌ | ✅ | ❌ | [doc](https://api.chatanywhere.tech/#/) |
## 🤖 Text Example
## 🎺 Multimodal Example
## 📥 Installation
1. **Clone the repository**
```sh
git clone https://github.com/yincongcyincong/MuseBot.git
cd MuseBot
```
2. **Install dependencies**
```sh
go mod tidy
```
3. **Set up environment variables**
```sh
export TELEGRAM_BOT_TOKEN="your_telegram_bot_token"
export DEEPSEEK_TOKEN="your_deepseek_api_key"
```
## 🚀 Usage
Run the bot locally:
```sh
go run main.go -telegram_bot_token=telegram-bot-token -deepseek_token=deepseek-auth-token
```
Use docker
```sh
docker pull jackyin0822/musebot:latest
docker run -d -v /home/user/data:/app/data -e TELEGRAM_BOT_TOKEN="telegram-bot-token" -e DEEPSEEK_TOKEN="deepseek-auth-token" --name my-telegram-bot jackyin0822/MuseBot:latest
```
```sh
ALIYUN:
docker pull crpi-i1dsvpjijxpgjgbv.cn-hangzhou.personal.cr.aliyuncs.com/jackyin0822/musebot:latest
```
command: (doc)[https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/param_conf.md]
## ⚙️ Configuration
You can configure the bot via environment variables:
| Variable Name | Description | Default Value |
|--------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------|
| TELEGRAM_BOT_TOKEN (required) | Your Telegram bot token | - |
| DEEPSEEK_TOKEN (required) | DeepSeek Api Key | - |
| OPENAI_TOKEN | Open AI Token | - |
| GEMINI_TOKEN | Gemini Token | - |
| OPEN_ROUTER_TOKEN | OpenRouter Token [doc](https://openrouter.ai/docs/quickstart) | - |
| ALIYUN_TOKEN | Aliyun Token [doc](https://bailian.console.aliyun.com/?spm=5176.12818093_47.overview_recent.1.663b2cc9zsj3BI&tab=doc#/doc/?type=model&url=2840915) | - |
| AI_302_TOKEN | 302-AI token [doc](https://302.ai/) | - |
| VOL_TOKEN | Vol Token [doc](https://www.volcengine.com/docs/82379/1399008#b00dee71) | - |
| CUSTOM_URL | custom deepseek url | https://api.deepseek.com/ |
| TYPE | deepseek/openai/gemini/openrouter/vol/302-ai/ollama/chatanywhere | deepseek |
| VOLC_AK | volcengine photo model ak [doc](https://www.volcengine.com/docs/6444/1340578) | - |
| VOLC_SK | volcengine photo model sk [doc](https://www.volcengine.com/docs/6444/1340578) | - |
| Ernie_AK | ernie ak [doc](https://cloud.baidu.com/doc/WENXINWORKSHOP/s/Sly8bm96d) | - |
| Ernie_SK | ernie sk [doc](https://cloud.baidu.com/doc/WENXINWORKSHOP/s/Sly8bm96d) | - |
| DB_TYPE | sqlite3 / mysql | sqlite3 |
| DB_CONF | ./data/telegram_bot.db / root:admin@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local | ./data/telegram_bot.db |
| ALLOWED_USER_IDS | user id, only these users can use bot, using "," splite. empty means all use can use it. 0 means all user is banned | - |
| ALLOWED_GROUP_IDS | chat id, only these chat can use bot, using "," splite. empty means all group can use it. 0 means all group is banned | - |
| LLM_PROXY | llm proxy | - |
| ROBOT_PROXY | robot proxy | - |
| LANG | en / zh | en |
| TOKEN_PER_USER | The tokens that each user can use | 10000 |
| ADMIN_USER_IDS | admin user, can use some admin commands | - |
| NEED_AT_BOT | is it necessary to trigger an at robot in the group | false |
| MAX_USER_CHAT | max existing chat per user | 2 |
| VIDEO_TOKEN | volcengine Api key[doc](https://www.volcengine.com/docs/82379/1399008#b00dee71) | - |
| HTTP_PORT | http server port | 36060 |
| USE_TOOLS | if normal conversation use function call tools or not | false |
| CA_FILE | http server ca file | - |
| CRT_FILE | http server crt file | - |
| KEY_FILE | http server key file | - |
| MEDIA_TYPE | openai/gemini/vol/openrouter/aliyun/302-ai create photo or video | vol |
| MAX_QA_PAIR | how many question and answer pairs as context | 15 |
| CHARACTER | background character | - |
### CUSTOM_URL
If you are using a self-deployed DeepSeek, you can set CUSTOM_URL to route requests to your self-deployed DeepSeek.
### DEEPSEEK_TYPE
deepseek: directly use deepseek service. but it's not very stable
others: see [doc](https://www.volcengine.com/docs/82379/1463946)
### DB_TYPE
support sqlite3 or mysql
### DB_CONF
if DB_TYPE is sqlite3, give a file path, such as `./data/telegram_bot.db`
if DB_TYPE is mysql, give a mysql link, such as
`root:admin@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local`, database must be created.
### LANG
choose a language for bot, English (`en`), Chinese (`zh`), Russian (`ru`).
### other config
[deepseek_conf](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/deepseekconf.md)
[photo_conf](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/photoconf.md)
[video_conf](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/videoconf.md)
[audio_conf](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/audioconf.md)
## Command
### /clear
clear all of your communication record with deepseek. this record use for helping deepseek to understand the context.
### /retry
retry last question.
### /txt_type /photo_type /video_type
choose txt/photo/video model type.
### /txt_model /img_model /video_model
choose txt/photo/video model.
### /balance
### /state
calculate one user token usage.
### /photo /edit_photo
using volcengine photo model create photo, deepseek don't support to create photo now. VOLC_AK and VOLC_SK is
necessary.[doc](https://www.volcengine.com/docs/6444/1340578)
/edit_photo will update you photo base on your description.
### /video
create video. `DEEPSEEK_TOKEN` must be volcengine Api key. deepseek don't support to create video
now. [doc](https://www.volcengine.com/docs/82379/1399008#b00dee71)
### /chat
allows the bot to chat through /chat command in groups,
without the bot being set as admin of the group.
### /help
### /task
multi agent communicate with each other!
### /change_photo
only for tencent app (wechat, qq, work wechat)
change photo base on your prompt.
### /rec_photo
only for tencent app (wechat, qq, work wechat)
recognize photo base on your prompt.
### /save_voice
only for tencent app (wechat, qq, work wechat)
save your voice to pc.
## Deployment
### Deploy with Docker
1. **Build the Docker image**
```sh
docker build -t MuseBot .
```
2. **Run the container**
```sh
docker run -d -v /home/user/xxx/data:/app/data -e TELEGRAM_BOT_TOKEN="telegram-bot-token" -e DEEPSEEK_TOKEN="deepseek-auth-token" --name my-bot MuseBot
```
## Contributing
Feel free to submit issues and pull requests to improve this bot. 🚀
## License
MIT License © 2025 jack yin