【工具推荐】MuseBot:给微信、qq、telegram等即时通讯软件增加一个ai bot

官网

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.

官方介绍

感谢

感谢阮一峰老师的weekly,很荣幸能登榜:GitHub - ruanyf/weekly: 科技爱好者周刊,每周五发布
感谢linux.do 社区,佬友们很给力,给一个我的介绍贴链接:https://linux.do/t/topic/1128110
感谢reddit社区,虽然封了我几个subreddit:https://www.reddit.com/

MuseBot

本仓库提供了一个是基于 Golang 构建的 智能机器人,集成了 LLM API,实现 AI 驱动的自然对话与智能回复。
它支持 OpenAIDeepSeekGeminiDoubaoQwen 等多种大模型,
并可无缝接入 TelegramDiscordSlackLark(飞书)钉钉企业微信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, see 文档.

支持平台

平台 支持情况 简要说明 文档 / 链接
: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: 文本示例


:trumpet: 多模态示例



: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
  

命令介绍: (文档)[MuseBot/static/doc/param_conf_ZH.md at main · yincongcyincong/MuseBot · GitHub]


:gear: 配置项

如果用参数形式,使用小写加下划线形式,比如./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 -
ALIYUN_TOKEN 阿里云百炼 Token doc -
AI_302_TOKEN 302.AI Token doc -
VOL_TOKEN 火山引擎通用 Token doc -
VOLC_AK 火山引擎多媒体 AK doc -
VOLC_SK 火山引擎多媒体 SK doc -
ERNIE_AK 百度文心大模型 AK doc -
ERNIE_SK 百度文心大模型 SK doc -
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参数
图片参数
视频参数


:speech_balloon: 命令

/clear

清除与 DeepSeek 的历史对话记录,用于上下文清理。

/retry

重试上一次问题。

/txt_type /photo_type /video_type /rec_type

选择你想用的 文字/图片/视频的 模型类型.


/txt_model /img_model /video_model /rec_model

选择具体的模型名称.


/mode

展示正在使用的模型信息

/state

统计用户的 Token 使用量。

/photo /edit_photo

/edit_photo 支持编辑图片。

/video

/chat

在群组中使用 /chat 命令与机器人对话,无需将机器人设置为管理员。

/help

显示帮助信息。


:rocket: Docker 部署

  1. 构建 Docker 镜像

    docker build -t musebot .
    
  2. 运行 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 去试用robot, 点个star吧!

QQ群:1031411708


:scroll: 开源协议

MIT License © 2025 Jack Yin