MuseBot

环境要求

• Go 开发环境（需能执行 go mod tidy / go run）
• Git 命令行工具
• Telegram Bot Token（TELEGRAM_BOT_TOKEN）
• 至少一个大模型 API Key，如 DeepSeek（DEEPSEEK_TOKEN）或 OpenAI（OPENAI_TOKEN）
• 可选：Docker（使用容器方式部署时需要）

安装与启动步骤

1. 1克隆仓库

   把 MuseBot 源码下载到本地，并进入项目目录，后续命令都在该目录执行。

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

   复制

2. 2安装依赖

   根据 go.mod 拉取并整理项目所需的 Go 依赖包，确保后续能正常编译运行。

   go mod tidy

   复制

3. 3设置环境变量

   填入你自己的 Telegram 机器人 Token 和 DeepSeek API Key。README 只给出 Telegram 和 DeepSeek 两个示例，其它平台按需再加。

   export TELEGRAM_BOT_TOKEN="your_telegram_bot_token"
   export DEEPSEEK_TOKEN="your_deepseek_api_key"

   复制

4. 4本地启动机器人

   用 go run 直接运行 main.go，并把 Telegram 与 DeepSeek 凭证以参数形式传入。参数名需使用小写加下划线。

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

   复制

5. 5拉取 Docker 镜像

   若不想装 Go 环境，可直接使用官方镜像 jackyin0822/musebot:latest；国内可换阿里云镜像地址。

   docker pull jackyin0822/musebot:latest

   复制

6. 6用容器运行

   先把数据目录权限设为 777，再挂载 /app/data 并映射 36060 端口启动容器。

   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 jackyin0822/MuseBot:latest

   复制

关键配置

如何确认成功

本地运行看控制台是否报错并持续输出日志；Docker 方式用 docker ps 确认 my-bot 容器处于 Up 状态，再到对应聊天平台给机器人发消息看是否有 AI 回复。

常见问题

注意事项

• Docker 方式默认映射 36060 端口，如与宿主机端口冲突请自行调整 -p 参数左侧端口。
• 不要将真实 Token/API Key 提交到公开仓库，建议仅通过环境变量或启动参数传入。
• README 未给出明确的健康检查接口，验证以容器状态和聊天平台实际回复为准。
• 更多参数说明见官方文档 static/doc/param_conf.md，图片、语音等能力另见对应文档。