【工具推薦】MuseBot：為微信、QQ、Telegram 等即時通訊軟體增添 AI 機器人功能

🛠工具与编程
1

官網

yincongcyincong/MuseBot：支援 Telegram、Discord、Slack、Lark（飛書）、釘釘、企業微信、QQ、微信，相容於 OpenAI、Gemini、DeepSeek、Doubao 和 OpenRouter 等多種大語言模型。提供智慧對話、圖片生成、影片創作等功能，適用於私聊與群組場景。

官方介紹

感謝

感謝阮一峰老師的 weekly，很榮幸能登上排行榜：GitHub - ruanyf/weekly: 科技爱好者周刊，每周五发布
感謝 linux.do 社群，前輩們非常熱情支持，附上一篇我的介紹文連結：https://linux.do/t/topic/1128110
感謝 reddit 社群，雖然封了我幾個 subreddit：https://www.reddit.com/

MuseBot

本倉儲提供一個基於 Golang 開發的 智慧機器人，整合了 LLM API，實現由 AI 驅動的自然對話與智慧回覆功能。
支援 OpenAI、DeepSeek、Gemini、Doubao、Qwen 等多種大型語言模型，
並可無縫接入 Telegram、Discord、Slack、Lark（飛書）、釘釘、企業微信、QQ、微信
等聊天平台，為使用者帶來更流暢、跨平台整合的 AI 對話體驗。
English Doc

:sun_with_face: 影片教學

最簡單教程：最简单的方法使用MuseBot_哔哩哔哩_bilibili
deepseek： 3分钟创建一个telegram智能deepseek机器人_哔哩哔哩_bilibili
gemini： 亲测超简单！3分钟搭建 Gemini 智能机器人，真的能聊！_哔哩哔哩_bilibili
chatgpt: 无需代码！3 分钟让 ChatGPT 接入 Telegram（MuseBot 教程）_哔哩哔哩_bilibili
豆包：我用豆包大模型打造的 Telegram Bot，太智能了！_哔哩哔哩_bilibili
如何使用 MCP：你还在手动写文章？AI 已经能自动打开网站+写作+存草稿了_哔哩哔哩_bilibili

:rocket: 功能特色

  • :robot: AI 回覆：透過大模型 API 提供聊天機器人回應。
  • :hourglass_not_done: 串流輸出：即時傳送回覆內容，提升使用者體驗。
  • :building_construction: 輕鬆部署：可在本機運行或部署至雲端伺服器。
  • :eyes: 圖像識別：使用圖片與大模型互動，詳見文件。
  • :trumpet: 支援語音：使用語音與大模型交流，詳見文件。
  • :ox: 函數呼叫：將 MCP 協定轉換為函數呼叫，詳見文件。
  • :ocean: RAG（檢索增強生成）：支援 RAG 以補充上下文資訊，詳見文件。
  • :sun_with_face: 管理平台（AdminPlatform）：使用管理平台來管理 MuseBot，詳見文件。
  • :first_quarter_moon_face: 註冊中心：支援服務註冊，機器人實例可自動註冊，詳見文件。
  • :rainbow: 監控資料：支援監控數據收集，詳見文件。
  • :dog_face: Cron：定時觸發 LLM，詳見文件。

支援平台

平台 支援狀態 簡要說明 文件 / 連結
:blue_square: Telegram :white_check_mark: 支援 Telegram 機器人（基於 go-telegram-bot-api，可處理命令、內聯按鈕、ForceReply 等） 文件
:rainbow: Discord :white_check_mark: 支援 Discord 機器人 文件
:first_quarter_moon_face: Web API :white_check_mark: 提供 HTTP/Web API 與 LLM 互動（適合建構自訂前端或後端整合） 文件
:large_blue_diamond: Slack :white_check_mark: 支援 Slack（Socket Mode / Events API / Block Kit 互動） 文件
:purple_circle: Lark（飛書） :white_check_mark: 支援 Lark 長連接與訊息處理（基於 larksuite SDK，支援圖片/音訊下載與訊息更新） 文件
:up_button: 釘釘 :white_check_mark: 支援釘釘長連結服務 文件
:high_voltage: Work WeChat :white_check_mark: 支援企業微信觸發大模型 文件
:high_voltage: QQ :white_check_mark: 支援 QQ 機器人觸發大模型 文件
:high_voltage: WeChat :white_check_mark: 支援微信觸發大模型 文件

支援之大型語言模型

模型 提供者 文字生成 圖片生成 影片生成 辨識照片 回傳語音 連結
:glowing_star: Gemini 谷歌 :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: 文件
:speech_balloon: ChatGPT OpenAI :white_check_mark: :white_check_mark: :cross_mark: :white_check_mark: :white_check_mark: 文件
:bird: Doubao 字節跳動 :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: 文件
:bird: Qwen 阿里雲 :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: 文件
:gear: 302.AI 302.AI :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark: :cross_mark: 文件
:brain: DeepSeek DeepSeek :white_check_mark: :cross_mark: :cross_mark: :cross_mark: :cross_mark: 文件
:globe_with_meridians: OpenRouter OpenRouter :white_check_mark: :white_check_mark: :cross_mark: :white_check_mark: :cross_mark: 文件
:globe_with_meridians: ChatAnywhere ChatAnywhere :white_check_mark: :white_check_mark: :cross_mark: :white_check_mark: :cross_mark: 文件

:robot: 文字範例

aa92b3c9580da6926a48fc1fc5c37c03
aa92b3c9580da6926a48fc1fc5c37c03750×856 136 KB

aa92b3c9580da6926a48fc1fc5c37c03
aa92b3c9580da6926a48fc1fc5c37c03758×998 147 KB

:trumpet: 多模態範例

aa92b3c9580da6926a48fc1fc5c37c03
aa92b3c9580da6926a48fc1fc5c37c03756×584 96.3 KB

aa92b3c9580da6926a48fc1fc5c37c03
aa92b3c9580da6926a48fc1fc5c37c03758×982 115 KB

:inbox_tray: 安裝

  1. 克隆倉庫

    git clone https://github.com/yincongcyincong/MuseBot.git
cd MuseBot

  2. 安裝依賴

    go mod tidy

  3. 設定環境變數

    export TELEGRAM_BOT_TOKEN="你的Telegram Bot Token"
export DEEPSEEK_TOKEN="你的DeepSeek API密鑰"

:rocket: 使用方法

在本機運行：

go run main.go -telegram_bot_token=telegram-bot-token -deepseek_token=deepseek-auth-token

使用 Docker 運行：

docker pull jackyin0822/musebot:latest
chmod 777 /home/user/data
docker run -d -v /home/user/data:/app/data -e TELEGRAM_BOT_TOKEN="你的Telegram Bot Token" -e DEEPSEEK_TOKEN="你的DeepSeek API密鑰" -p 36060:36060  --name my-bot jackyin0822/musebot:latest

阿里雲:
docker pull crpi-i1dsvpjijxpgjgbv.cn-hangzhou.personal.cr.aliyuncs.com/jackyin0822/musebot:latest
chmod 777 /home/user/data
docker run -d -v /home/user/data:/app/data -e TELEGRAM_BOT_TOKEN="telegram-bot-token" -e DEEPSEEK_TOKEN="deepseek-auth-token" -p 36060:36060 --name my-bot  crpi-i1dsvpjijxpgjgbv.cn-hangzhou.personal.cr.aliyuncs.com/jackyin0822/musebot:latest
 
```命令介紹: (文件)[https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/param_conf_ZH.md]

---

## ⚙️ 設定項

如果使用參數形式，請使用小寫加底線的形式，例如 ./MuseBot -telegram_bot_token=xxx| 環境變數名字                          | 描述                                                                                  | 預設值                   |
|---------------------------------|-------------------------------------------------------------------------------------|-----------------------|
| **TELEGRAM_BOT_TOKEN**          | Telegram 機器人 Token                                                                  | -                     |
| **DISCORD_BOT_TOKEN**           | Discord 機器人 Token                                                                   | -                     |
| **SLACK_BOT_TOKEN**             | Slack 機器人 Bot Token                                                                 | -                     |
| **SLACK_APP_TOKEN**             | Slack App-level Token                                                               | -                     |
| **LARK_APP_ID**                 | 飛書 App ID                                                                           | -                     |
| **LARK_APP_SECRET**             | 飛書 App Secret                                                                       | -                     |
| **DING_CLIENT_ID**              | 釘釘 App Key / Client ID                                                              | -                     |
| **DING_CLIENT_SECRET**          | 釘釘 App Secret                                                                       | -                     |
| **DING_TEMPLATE_ID**            | 釘釘 模板消息 ID                                                                          | -                     |
| **COM_WECHAT_TOKEN**            | 企業微信 Token                                                                          | -                     |
| **COM_WECHAT_ENCODING_AES_KEY** | 企業微信 EncodingAESKey                                                                 | -                     |
| **COM_WECHAT_CORP_ID**          | 企業微信 CorpID                                                                         | -                     |
| **COM_WECHAT_SECRET**           | 企業微信 Secret                                                                         | -                     |
| **COM_WECHAT_AGENT_ID**         | 企業微信 AgentID                                                                        | -                     |
| **WECHAT_APP_ID**               | 微信公眾號 AppID                                                                         | -                     |
| **WECHAT_APP_SECRET**           | 微信公眾號 AppSecret                                                                     | -                     |
| **WECHAT_ENCODING_AES_KEY**     | 微信公眾號 EncodingAESKey                                                                | -                     |
| **WECHAT_TOKEN**                | 微信公眾號 Token                                                                         | -                     |
| **WECHAT_ACTIVE**               | 是否啟用公眾號消息監聽（true/false）                                                             | false                 |
| **QQ_APP_ID**                   | QQ 開放平台 AppID                                                                       | -                     |
| **QQ_APP_SECRET**               | QQ 開放平台 AppSecret                                                                   | -                     |
| **QQ_ONEBOT_RECEIVE_TOKEN**     | ONEBOT → MuseBot 事件推送 token                                                         | MuseBot               |
| **QQ_ONEBOT_SEND_TOKEN**        | MuseBot → ONEBOT 消息發送 token                                                         | MuseBot               |
| **QQ_ONEBOT_HTTP_SERVER**       | ONEBOT HTTP 服務地址                                                                    | http://127.0.0.1:3000 |
| **DEEPSEEK_TOKEN**              | DeepSeek API Key                                                                    | -                     |
| **OPENAI_TOKEN**                | OpenAI API Key                                                                      | -                     |
| **GEMINI_TOKEN**                | Google Gemini Token                                                                 | -                     |
| **OPEN_ROUTER_TOKEN**           | OpenRouter Token [doc](https://openrouter.ai/docs/quickstart)                       | -                     |
| **ALIYUN_TOKEN**                | 阿里雲百煉 Token [doc](https://bailian.console.aliyun.com/#/doc/?type=model\u0026url=2840915) | -                     |
| **AI_302_TOKEN**                | 302.AI Token [doc](https://302.ai/)                                                 | -                     |
| **VOL_TOKEN**                   | 火山引擎通用 Token [doc](https://www.volcengine.com/docs/82379/1399008#b00dee71)          | -                     |
| **VOLC_AK**                     | 火山引擎多媒體 AK [doc](https://www.volcengine.com/docs/6444/1340578)                      | -                     |
| **VOLC_SK**                     | 火山引擎多媒體 SK [doc](https://www.volcengine.com/docs/6444/1340578)                      | -                     |
| **ERNIE_AK**                    | 百度文心大模型 AK [doc](https://cloud.baidu.com/doc/WENXINWORKSHOP/s/Sly8bm96d)            | -                     |
| **ERNIE_SK**                    | 百度文心大模型 SK [doc](https://cloud.baidu.com/doc/WENXINWORKSHOP/s/Sly8bm96d)            | -                     |
| **ALIYUN_TOKEN**                | 阿里雲大模型 Token                                                                        | -                     |
| **AI_302_TOKEN**                | 302.AI 平台 Token                                                                     | -                     |
| **OPEN_ROUTER_TOKEN**           | OpenRouter API Key                                                                  | -                     |
| **CUSTOM_URL**                  | 自訂 LLM API 地址                                                                      |                       |
| **TYPE**                        | LLM 類型（deepseek/openai/gemini/openrouter/vol/302-ai/chatanywhere）                   | deepseek              |
| **MEDIA_TYPE**                  | 圖片/影片生成模型來源（openai/gemini/vol/openrouter/aliyun/302-ai）                             | vol                   |
| **DB_TYPE**                     | 資料庫類型（sqlite3/mysql）                                                                | sqlite3               |
| **DB_CONF**                     | 資料庫設定路徑或連接字串                                                                       | ./data/muse_bot.db    |
| **LLM_PROXY**                   | LLM 網路代理（如 http://127.0.0.1:7890）                                                   | -                     |
| **ROBOT_PROXY**                 | 機器人存取代理（如 http://127.0.0.1:7890）                                                    | -                     |
| **LANG**                        | 語言（en/zh）                                                                           | en                    |
| **TOKEN_PER_USER**              | 每位使用者可用的最大 token 數，0為不限制token                                                        | 10000                 |
| **MAX_USER_CHAT**               | 每位使用者可同時存在的最大對話數                                                                     | 2                     |
| **HTTP_HOST**                   | MuseBot HTTP 服務監聽埠                                                                 | :36060                |
| **USE_TOOLS**                   | 是否啟用 Function Call 工具（true/false）                                                   | false                 |
| **MAX_QA_PAIR**                 | 上下文保留問答對數量                                                                          | 100                   |
| **CHARACTER**                   | AI 的人格設定描述                                                                          | -                     |
| **CRT_FILE**                    | HTTPS 公鑰檔案路徑                                                                        | -                     |
| **KEY_FILE**                    | HTTPS 私鑰檔案路徑                                                                        | -                     || **CA_FILE**                     | HTTPS CA 憑證路徑                                                                       | -                     |
| **ADMIN_USER_IDS**              | 管理員用戶 ID，以逗號分隔                                                                   | -                     |
| **ALLOWED_USER_IDS**            | 允許使用的用戶 ID，以逗號分隔；空=全部可用；0=全部禁用                                             | -                     |
| **ALLOWED_GROUP_IDS**           | 允許使用的群組 ID，以逗號分隔；空=全部可用；0=全部禁用                                             | -                     |
| **BOT_NAME**                    | Bot 名稱                                                                              | MuseBot               |
| **CHAT_ANY_WHERE_TOKEN**        | ChatAnyWhere 平台 Token                                                               | -                     |
| **SMART_MODE**                  | 自動檢測你想生成什麼樣的內容                                                                  | true                  |
| **SEND_MCP_RES**                | 是否發送 MCP 的請求結果                                                                    | false                 |
| **DEFAULT_MODEL**               | 用戶預設使用的文字模型                                                                       | -                     |

### 其他配置

[deepseek 參數](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/deepseekconf_ZH.md)  
[圖片參數](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/photoconf_ZH.md)  
[影片參數](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/videoconf_ZH.md)

---

## 💬 命令

### `/clear`

清除與 DeepSeek 的歷史對話記錄，用於上下文清理。

### `/retry`

重試上一次問題。

### `/txt_type /photo_type /video_type /rec_type`

選擇你想使用的 文字/圖片/影片 的模型類型。  
<img width="374" alt="aa92b3c9580da6926a48fc1fc5c37c03" src="upload://ieqm2bdEpw0AIdaqw4M3VQ79Qc2.jpeg">  
<img width="374" alt="aa92b3c9580da6926a48fc1fc5c37c03" src="upload://k7gtrPTzfgQRGmAfzpA1jE9XnMm.jpeg">

### `/txt_model /img_model /video_model /rec_model`

選擇具體的模型名稱。  
<img width="374" alt="aa92b3c9580da6926a48fc1fc5c37c03" src="upload://yHQg2hVBdC6lyNCvFVPfpB74mnV.jpeg">  
<img width="374" alt="aa92b3c9580da6926a48fc1fc5c37c03" src="upload://3pMgosCHtQxUYdbOOkS5zFaDHEC.jpeg">

### `/mode`

顯示目前正在使用的模型資訊  
<img width="374" alt="aa92b3c9580da6926a48fc1fc5c37c03" src="upload://6UzLxBzCnUmFPXyd5NhAwHiedbW.jpeg">

### `/state`

統計用戶的 Token 使用量。

<img width="400" src="upload://3EDCuqoIBMpGagecLwRBlvaKALq.jpeg" alt="">

### `/photo` `/edit_photo`

<img width="400" src="upload://pCIsgcAaLKxFFpAhlJhQ5TLnhZz.jpeg" alt="">  

`/edit_photo` 支援編輯圖片。  
<img width="374" alt="aa92b3c9580da6926a48fc1fc5c37c03" src="upload://rJq2yROdZn3hGLiOiowMlkurvwD.jpeg">

### `/video`

<img width="400" src="upload://rj2WAL9tM8T5Am6Lnf2BMYMiZyh.jpeg" alt="">

### `/chat`

在群組中使用 `/chat` 命令與機器人對話，無需將機器人設定為管理員。

<img width="400" src="upload://i18HRs461fEyc4qlEKPqUOsmx34.jpeg" alt="">

### `/help`

顯示幫助訊息。

<img width="400" src="upload://1DjGwwkHhXyXfyWMACZNJRg9Sic.jpeg" alt="">

---

## 🚀 Docker 部署

1. **建置 Docker 映像**
   ```sh
   docker build -t musebot .
  1. 運行 Docker 容器
    docker run -d -v /home/user/xxx/data:/app/data -e TELEGRAM_BOT_TOKEN="你的Telegram Bot Token" -e DEEPSEEK_TOKEN="你的DeepSeek API密鑰" --name my-telegram-bot musebot

:handshake: 貢獻

歡迎提交 Issue 和 Pull Request，一起優化和改進本專案！:rocket:

群聊

Telegram 群組: Telegram: Join Group Chat Guanwushan_bot。
每人有 10000 token 可試用機器人，順手點個 star 吧！

QQ 群：1031411708

:scroll: 開源協議

MIT License © 2025 Jack Yin