gardel/Mofox-Core
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
7a72f5c26e7fa26f259a28b3799af5c8679c6204
Mofox-Core/docs/manual_deploy_macos.md

4.5 KiB
Raw Blame History

📦 macOS系统手动部署MaiMbot麦麦指南

准备工作

  • 一台搭载了macOS系统的设备（macOS 12.0 或以上）
  • QQ小号（QQ框架的使用可能导致qq被风控，严重（小概率）可能会导致账号封禁，强烈不推荐使用大号）
  • Homebrew包管理器
  • 可用的大模型API
  • 一个AI助手，网上随便搜一家打开来用都行，可以帮你解决一些不懂的问题
  • 以下内容假设你对macOS系统有一定的了解，如果觉得难以理解，请直接用Windows系统部署Windows系统部署指南或使用Windows一键包部署
  • 终端应用（iTerm2等）

环境配置

1️⃣ Python环境配置

# 检查Python版本（macOS自带python可能为2.7）
python3 --version

# 通过Homebrew安装Python
brew install python@3.12

# 设置环境变量（如使用zsh）
echo 'export PATH="/usr/local/opt/python@3.12/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 验证安装
python3 --version  # 应显示3.12.x
pip3 --version     # 应关联3.12版本

2️⃣ 创建虚拟环境

# 方法1：使用venv（推荐）
python3 -m venv maimbot-venv
source maimbot-venv/bin/activate    # 激活虚拟环境

# 方法2：使用conda
brew install --cask miniconda
conda create -n maimbot python=3.9
conda activate maimbot  # 激活虚拟环境

# 安装项目依赖
# 请确保已经进入虚拟环境再执行
pip install -r requirements.txt

数据库配置

3️⃣ 安装MongoDB

请参考官方文档

NapCat

4️⃣ 安装与配置Napcat

  • 安装 可以使用Napcat官方提供的macOS安装工具 由于权限问题，补丁过程需要手动替换 package.json，请注意备份原文件～
  • 配置 使用QQ小号登录，添加反向WS地址: ws://127.0.0.1:8080/onebot/v11/ws

配置文件设置

5️⃣ 生成配置文件

可先运行一次

# 在项目目录下操作
nb run
# 或
python3 bot.py

之后你就可以找到.env和bot_config.toml这两个文件了

关于文件内容的配置请参考：

启动机器人

6️⃣ 启动麦麦机器人

# 在项目目录下操作
nb run
# 或
python3 bot.py

启动管理

7️⃣ 通过launchd管理服务

创建plist文件：

nano ~/Library/LaunchAgents/com.maimbot.plist

内容示例（需替换实际路径）：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.maimbot</string>
    
    <key>ProgramArguments</key>
    <array>
        <string>/path/to/maimbot-venv/bin/python</string>
        <string>/path/to/MaiMbot/bot.py</string>
    </array>
    
    <key>WorkingDirectory</key>
    <string>/path/to/MaiMbot</string>
    
    <key>StandardOutPath</key>
    <string>/tmp/maimbot.log</string>
    <key>StandardErrorPath</key>
    <string>/tmp/maimbot.err</string>
    
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>

加载服务：

launchctl load ~/Library/LaunchAgents/com.maimbot.plist
launchctl start com.maimbot

查看日志：

tail -f /tmp/maimbot.log

常见问题处理

  1. 权限问题
# 遇到文件权限错误时
chmod -R 755 ~/Documents/MaiMbot
  1. Python模块缺失
# 确保在虚拟环境中
source maimbot-venv/bin/activate  # 或 conda 激活
pip install --force-reinstall -r requirements.txt
  1. MongoDB连接失败
# 检查服务状态
brew services list
# 重置数据库权限
mongosh --eval "db.adminCommand({setFeatureCompatibilityVersion: '5.0'})"

系统优化建议

  1. 关闭App Nap
# 防止系统休眠NapCat进程
defaults write NSGlobalDomain NSAppSleepDisabled -bool YES
  1. 电源管理设置
# 防止睡眠影响机器人运行
sudo systemsetup -setcomputersleep Never