胜算云

大肥鱼| Mac QQ 安装教程

Z
Zoey编辑于 2026-11-11
522 次阅读

用 Mac 给 QQ 小号接上 AI,再换上“大肥鱼”的人格,就能像和好友聊天一样,找它闲聊、改文案,或者一起沟通工作思路。

这篇文章带你跑通文字聊天和人格回复。想让大肥鱼发语音、拥有长期记忆等功能,可以在 AstrBot 里按需安装相应插件。也可以试试将本教程交给 DSH 让 AI 配置。

⚠️账号风险告知

无论使用 Windows 还是 Mac,通过第三方工具接入 QQ 机器人都可能触发账号风控或封禁,目前没有经过验证的免封措施。请勿使用主号,建议使用没有重要资料的小号。新注册的小号建议先正常使用几天养号,再接入机器人来降低风险。

准备一台 Mac、日常使用的 QQ 大号,再给大肥鱼留一个专用小号。模型账号和 API Key 在第 5 步准备。下面用安装包和网页完成配置,不需要输入终端命令。

安装 Docker

Docker 帮我们在 Mac 上运行大肥鱼需要的程序,省去分别配置运行环境的麻烦。装好后保持运行就行,不需要学会 Docker。

  • 点左上角苹果标志 →「关于本机」,确认电脑是 Apple M 系列还是 Intel。
  • 到 Docker 下载页选对应版本。打开 Docker.dmg,把 Docker 拖进「应用程序」后启动,按提示完成设置。出现账号登录页时,可选「Skip」跳过。看到「Engine running」就可以继续。

启动大肥鱼

我们把 AstrBot 和 NapCat 的启动配置整理成了一个QQ 大肥鱼安装包。打开安装包下载文件夹,选择你的芯片对应的一份。

  • M 系列选「Apple芯片-含组件版」,约 1.37 GB,已包含运行组件。
  • Intel选「Intel-在线测试版」,首次启动会联网下载组件。
  • 等下载完成再解压,打开「QQ大肥鱼.app」,点「安装并启动」→「开始」。首次准备组件可能需要等待,完成后会自动打开安装向导;也可以手动点「打开安装向导」。
  • 向导页面保留,后面要从里面复制口令、打开管理网页。

若 macOS 拦截打开,先核对文件来源,然后按Apple 的应用打开说明处理。

在 NapCat 登录 QQ 小号

NapCat 负责登录机器人 QQ,并收发消息。在安装向导点「打开 NapCat」,用向导里的「NapCat 管理口令」填写登录页的 Token。

进入账号页,用手机 QQ 扫码,注意这里登录的是大肥鱼专用小号。日常 Mac QQ 用大号。小号登录成功后,再继续下一步。

连接 AstrBot

AstrBot 负责调用 AI 模型、管理人格和插件。点击向导的「打开 AstrBot」,进入它的网页后台。

首次用户名为 AstrBot。初始密码在 Docker Desktop → qq-dafeiyu → AstrBot → Logs 查看(可点击 Cmd+F 搜索 “password”) ,登录后按提示设置账号。

本教程安装包已预置 NapCat 的连接配置,这里只需要在 AstrBot 创建对应的机器人即可。自行安装 NapCat 的用户不能直接省略连接设置。

在 AstrBot 点「机器人」→「创建机器人」→「OneBot v11」,照表填写并保存。

配置项填写内容
IDqq-dafeiyu
启用打开
反向 WebSocket 主机地址0.0.0.0
端口6199
反向 WebSocket Token复制本机安装向导第 2 步的连接口令
这里的连接口令和 NapCat 登录口令用途不同,按向导分别复制。在 AstrBot「数据与日志」看到 OneBot 适配器已连接,就连好了。

接上聊天模型

🎁 通过此链接注册胜算云,可领取 5 元 Token 体验额度。注册后,到API Key 管理页创建并复制自己的 Key,用它把模型接到 AstrBot。

在 AstrBot 点「模型提供商」→「对话」→「新增」,选择「SSYCloud(胜算云)」,填入 API Key。API 地址已预填,核对为下方地址即可。

https://router.shengsuanyun.com/api/v1

点「保存并获取模型」,添加一个聊天模型。需要手动填写模型时,从模型中心复制完整模型 ID。

添加成功后,进入「配置文件」,选择 QQ 使用的配置,在「AI → 模型 → 对话模型」选中刚刚配置的模型并保存。

换上大肥鱼人格

人格就是它的角色设定和说话习惯。在安装向导中点击「打开大肥鱼人格文本」,复制正文。回到 AstrBot「人格设定」,新建“大肥鱼”,粘贴到「系统提示词」并保存。

再到「配置文件」,选中 QQ 使用的配置,把默认人格改为“大肥鱼”并保存。

用日常 QQ 大号添加小号为好友,在手机小号里同意申请。然后用大号分三次发送下面的消息。/new 会新建会话,避免旧聊天影响人格测试。

/help
/new
大肥鱼,你是谁,最喜欢吃什么?

收到指令列表、新会话提示,再看到它按“大肥鱼”的设定回答,就可以开始聊天了。

以后使用时保持 Mac 唤醒、Docker 和大肥鱼运行;QQ 掉线后到 NapCat 重新扫码。

进阶玩法·更多插件

聊天能力接入后,还可以按需要添加更多功能。下面这些功能需要单独配置,点击对应教程操作。遇到问题,可以把报错发给大肥鱼,让它协助排查。

人格与方案参考大肥鱼原项目,更多配置见详细参考。


—— 完 ——