想拥有一个既聪明又保护隐私的QQ聊天机器人吗？这份指南提供了从云端到本地的完整部署方案，结合AstrBot框架与NapCat协议端，让你轻松构建专属AI伙伴，无论是接入在线大模型还是部署本地模型，都能按需实现。
智能速览
AstrBot是支持多平台的机器人开发框架。
NapCat作为QQ协议端实现机器人与QQ连接。
可接入DeepSeek等多种在线大模型API。
通过Ollama部署本地视觉模型Qwen2-VL。
支持自定义人设与插件扩展功能。
精华内容
搭建机器人并非难事，关键在于选对工具并理顺配置流程。接下来，将逐步拆解核心组件的部署与联动，从框架安装到模型配置，一步步完成从零到一的构建。
核心框架部署
首先，获取并部署AstrBot框架与NapCat协议端。通过官方渠道下载对应版本的压缩包，解压后需右键属性解除文件锁定。随后，运行AstrBot启动器和NapCat的可执行文件，等待初始化安装完成。这两个组件是整个系统的基石，前者是机器人的“大脑”，负责处理逻辑和调用模型；后者则是机器人的“神经”，负责与QQ服务器进行通信。
网络配置与连接
建立框架与协议端的通信是关键一步。在NapCat的WebUI中，需配置WebSocket服务端，将监听地址从`127.0.0.1`修改为`0.0.0.0`以允许局域网访问，并删除登录码简化操作。接着，新建WebSocket客户端，目标地址设为`ws://127.0.0.1:6199/ws`，确保NapCat能主动连接AstrBot。配置完成后，在AstrBot的实时调试中启用连接，当状态显示适配器链接成功，即代表通信链路已打通。
接入在线大模型
机器人需要语言模型才能进行对话。在AstrBot的模型提供商中，可选择添加如DeepSeek等服务。获取API Key并填入配置后，系统会自动拉取可用模型列表，例如用于常规聊天的`deepseek-chat`和用于深度思考的`deepseek-reasoner`。选择所需模型并启用后，机器人便具备了云端对话能力。国内部分服务商如智谱AI提供免费试用，降低了体验门槛。
本地模型部署方案
对于追求隐私或有离线需求的用户，本地部署是理想选择。通过Ollama可以便捷管理本地模型。下载安装包后，可通过CMD命令`OllamaSetup.exe /DIR=路径`自定义安装位置。为确保全局可用，需将Ollama路径添加至系统环境变量Path中。重启后，访问官网模型库，根据显卡显存选择合适模型，如具备视觉能力的`Qwen2-VL`，推荐8GB显存部署8B版本。使用`ollama run qwen2-vl:2b`命令即可下载并运行模型。
通过这套组合，一个功能强大且高度可定制的QQ机器人便搭建完成。无论是利用云端模型的智慧，还是享受本地模型的私密，都展现了开源框架的灵活性。未来，借助丰富的插件生态，它还能进化为更得力的AI助手，探索更多可能性。
