# 【工具推荐】MuseBot：为微信、QQ、Telegram 等即时通讯软件添加 AI 机器人 **URL:** \ **Category:** 🛠工具与编程\ **Created:** [2025 年10 月 24 日 14:43 UTC](https://forum.beginner.center/t/topic/2305 "2025-10-24T14:43:45Z")\ **Posts on this page:** 1\ **Page:** 1
作者： ![doggie](https://forum.beginner.center/user_avatar/forum.beginner.center/doggie/32/550_2.png) [@doggie](https://forum.beginner.center/u/doggie)\ 发布日期： [2025 年10 月 24 日 14:43 UTC](https://forum.beginner.center/t/topic/2305/1 "2025-10-24T14:43:45Z")
# 官网 [yincongcyincong/MuseBot：支持 Telegram、Discord、Slack、Lark（飞书）、钉钉、企业微信、QQ、微信，兼容 OpenAI、Gemini、DeepSeek、Doubao 和 OpenRouter 等多种大语言模型。提供智能对话、图像生成、视频创作等功能，适用于私聊和群组场景。](https://github.com/yincongcyincong/MuseBot) # 官方介绍 # 感谢 感谢阮一峰老师的 weekly，很荣幸能登榜：[GitHub - ruanyf/weekly: 科技爱好者周刊，每周五发布](https://github.com/ruanyf/weekly) 感谢 linux.do 社区，佬友们很给力，附上我的介绍帖链接：[https://linux.do/t/topic/1128110](https://linux.do/t/topic/1128110) 感谢 reddit 社区，虽然封了我几个 subreddit：[https://www.reddit.com/](https://www.reddit.com/) # MuseBot 本仓库提供一个基于 **Golang** 构建的 **智能机器人** ，集成 **LLM API** ，实现由 AI 驱动的自然对话与智能回复。 支持 **OpenAI** 、 **DeepSeek** 、 **Gemini** 、 **Doubao** 、 **Qwen** 等多种大模型， 并可无缝接入 **Telegram** 、 **Discord** 、 **Slack** 、 **Lark（飞书）** 、 **钉钉** 、 **企业微信** 、 **QQ** 、 **微信** 等聊天平台，为用户带来更加流畅、跨平台联通的 AI 对话体验。 [English Doc](https://github.com/yincongcyincong/MuseBot) * * * ## 🌞 视频 最简单教程：[最简单的方法使用MuseBot\_哔哩哔哩\_bilibili](https://www.bilibili.com/video/BV1f9nCzoERb/) deepseek：[3分钟创建一个telegram智能deepseek机器人\_哔哩哔哩\_bilibili](https://www.bilibili.com/video/BV1CB8kzHEJi/) gemini：[亲测超简单！3分钟搭建 Gemini 智能机器人，真的能聊！\_哔哩哔哩\_bilibili](https://www.bilibili.com/video/BV1D4htz4Ekv/) chatgpt：[无需代码！3 分钟让 ChatGPT 接入 Telegram（MuseBot 教程）\_哔哩哔哩\_bilibili](https://www.bilibili.com/video/BV1RutxzJEGY/) 豆包：[我用豆包大模型打造的 Telegram Bot，太智能了！\_哔哩哔哩\_bilibili](https://www.bilibili.com/video/BV1QDbEzwE43/) 如何使用 MCP：[你还在手动写文章？AI 已经能自动打开网站+写作+存草稿了\_哔哩哔哩\_bilibili](https://www.bilibili.com/video/BV1JbtJzVEJd/) ## 🚀 功能特性 - 🤖 **AI 回复** ：通过大模型 API 提供聊天机器人回复。 - ⏳ **流式输出** ：实时发送回复内容，提升用户体验。 - 🏗 **轻松部署** ：可在本地运行或部署至云服务器。 - 👀 **图像识别** ：结合图片与大模型交互，详见[文档](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/photoconf_ZH.md)。 - 🎺 **支持语音** ：使用语音与大模型交流，详见[文档](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/audioconf_ZH.md)。 - 🐂 **函数调用** ：将 MCP 协议转换为函数调用，详见[文档](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/functioncall_ZH.md)。 - 🌊 **RAG（检索增强生成）** ：支持 RAG 填充上下文，详见[文档](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/rag_ZH.md)。 - 🌞 **管理平台（AdminPlatform）** ：通过管理平台控制 MuseBot，详见[文档](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/admin_ZH.md)。 - 🌛 **注册中心** ：支持服务注册，机器人实例可自动注册，详见[文档](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/register_ZH.md)。 - 🌈 **监控数据** ：支持监控指标收集，详见[文档](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/metrics_ZH.md)。 - 🐶 **Cron** ：定时触发 LLM，见[文档](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/cron_ZH.md)。 * * * ## 支持平台 | 平台 | 支持情况 | 简要说明 | 文档 / 链接 | | --- | --- | --- | --- | | 🟦 **Telegram** | ✅ | 支持 Telegram 机器人（基于 go-telegram-bot-api，可处理命令、内联按钮、ForceReply 等） | [文档](https://github.com/yincongcyincong/MuseBot/blob/main/README_ZH.md) | | 🌈 **Discord** | ✅ | 支持 Discord 机器人 | [文档](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/discord_ZH.md) | | 🌛 **Web API** | ✅ | 提供 HTTP/Web API 接口用于与 LLM 交互（适合构建自定义前端或后端集成） | [文档](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/web_api_ZH.md) | | 🔷 **Slack** | ✅ | 支持 Slack（Socket Mode / Events API / Block Kit 交互） | [文档](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/slack_ZH.md) | | 🟣 **Lark（飞书）** | ✅ | 支持 Lark 长连接与消息处理（基于 larksuite SDK，支持图片/音频下载与消息更新） | [文档](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/lark_ZH.md) | | 🆙 **钉钉** | ✅ | 支持钉钉长链接服务 | [文档](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/dingding_ZH.md) | | ⚡ **Work WeChat** | ✅ | 支持企业微信触发大模型 | [文档](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/com_wechat_ZH.md) | | ⚡ **QQ** | ✅ | 支持 QQ 机器人触发大模型 | [文档](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/qq_ZH.md) | | ⚡ **WeChat** | ✅ | 支持微信触发大模型 | [文档](https://github.com/yincongcyincong/MuseBot/blob/main/static/doc/wechat_ZH.md) | ## 支持的大型语言模型 | 模型 | 提供方 | 文本生成 | 图片生成 | 视频生成 | 识别照片 | 返回语音 | 链接 | | --- | --- | --- | --- | --- | --- | --- | --- | | 🌟 **Gemini** | 谷歌 | ✅ | ✅ | ✅ | ✅ | ✅ | [文档](https://gemini.google.com/app) | | 💬 **ChatGPT** | OpenAI | ✅ | ✅ | ❌ | ✅ | ✅ | [文档](https://chat.openai.com) | | 🐦 **Doubao** | 字节跳动 | ✅ | ✅ | ✅ | ✅ | ✅ | [文档](https://www.volcengine.com/) | | 🐦 **Qwen** | 阿里云 | ✅ | ✅ | ✅ | ✅ | ✅ | [文档](https://bailian.console.aliyun.com/?spm=5176.12818093_47.overview_recent.1.663b2cc9wXXcVC%5Cu0026tab=api#/api) | | ⚙ **302.AI** | 302.AI | ✅ | ✅ | ✅ | ✅ | ❌ | [文档](https://302.ai/) | | 🧠 **DeepSeek** | DeepSeek | ✅ | ❌ | ❌ | ❌ | ❌ | [文档](https://www.deepseek.com/) | | 🌐 **OpenRouter** | OpenRouter | ✅ | ✅ | ❌ | ✅ | ❌ | [文档](https://openrouter.ai/) | | 🌐 **ChatAnywhere** | ChatAnywhere | ✅ | ✅ | ❌ | ✅ | ❌ | [文档](https://api.chatanywhere.tech/#/) | ## 🤖 文本示例 ![aa92b3c9580da6926a48fc1fc5c37c03](https://discoursecdn.beginner.center/original/2X/3/393421195f0049b7eae4b25394ea515af0f5cda9.jpeg) ![aa92b3c9580da6926a48fc1fc5c37c03](https://discoursecdn.beginner.center/original/2X/d/d159537b597a2ca652c36b995f269a662f705c22.jpeg) ## 🎺 多模态示例 ![aa92b3c9580da6926a48fc1fc5c37c03](https://discoursecdn.beginner.center/original/2X/8/8a20ab7109f8cf0b89dd0c8308164f8980d0281d.jpeg) ![aa92b3c9580da6926a48fc1fc5c37c03](https://discoursecdn.beginner.center/original/2X/e/ebba773d13cbd9b95300e6e09cbedd353b033c4f.jpeg) * * * ## 📥 安装 1. **克隆仓库** 2. **安装依赖** 3. **设置环境变量** * * * ## 🚀 使用方法 在本地运行： ```sh go run main.go -telegram_bot_token=telegram-bot-token -deepseek_token=deepseek-auth-token ``` 使用 Docker 运行： ```sh 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 ``` ````sh 阿里云: 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` 选择你想要使用的文字/图片/视频模型类型。 aa92b3c9580da6926a48fc1fc5c37c03 aa92b3c9580da6926a48fc1fc5c37c03 ### `/txt_model /img_model /video_model /rec_model` 选择具体的模型名称。 aa92b3c9580da6926a48fc1fc5c37c03 aa92b3c9580da6926a48fc1fc5c37c03 ### `/mode` 显示当前正在使用的模型信息 aa92b3c9580da6926a48fc1fc5c37c03 ### `/state` 统计用户的 Token 使用量。 ### `/photo` `/edit_photo` `/edit_photo` 支持图片编辑。 aa92b3c9580da6926a48fc1fc5c37c03 ### `/video` ### `/chat` 在群组中使用 `/chat` 命令与机器人对话，无需将机器人设置为管理员。 ### `/help` 显示帮助信息。 --- ## 🚀 Docker 部署 1. **构建 Docker 镜像** ```sh docker build -t musebot . ```` 1. **运行 Docker 容器** ```sh 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 ``` * * * ## 🤝 贡献 欢迎提交 Issue 和 Pull Request，一起优化和改进本项目！🚀 ## 群聊 Telegram 群组: [Telegram: Join Group Chat](https://t.me/+WtaMcDpaMOlhZTE1%EF%BC%8C%E6%88%96%E5%B0%9D%E8%AF%95%E4%B8%80%E4%B8%8B) Guanwushan\_bot。 每位用户有 **10000** token 可用于试用机器人，请顺手点个 star 吧！ QQ 群：1031411708 * * * ## 📜 开源协议 MIT License © 2025 Jack Yin