大肥鱼｜ Mac QQ 安装教程
参考文章 · 原文来源：胜算云精益社区
用 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」，照表填写并保存。
| 配置项 | 填写内容 |
|---|---|
| ID | qq-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 重新扫码。
进阶玩法·更多插件
聊天能力接入后，还可以按需要添加更多功能。下面这些功能需要单独配置，点击对应教程操作。遇到问题，可以把报错发给大肥鱼，让它协助排查。
- 运行 Skill，让它能够在市场寻找适合任务的 Skill、批量处理任务。
- 看图和听语音，让它理解你发来的图片、语音。
- 语音回复，在 QQ 里收到它发来的语音条。
- 长期记忆，保存并在新会话中检索你的偏好。
- 主动聊天，按配置的时段和条件主动找你。