大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



 
  
    
     
AstrBot 是一款聚焦 AI 能力落地的机器人框架，核心功能是对接各类 AI 大模型，并通过 OneBot 协议与 NapCat 配合，实现 账号的智能消息收发、AI 对话、插件调用（如天气查询、点歌、群管理）等操作，还支持自定义人设、MCP 服务扩展，能把普通 账号变成具备智能交互能力的助手。
 

从使用者角度来说，AstrBot+NapCat 最打动我的是上手门槛极低，Docker 一键部署后，几分钟就能完成基础配置，DeepSeek AI 接入后对话响应流畅，自定义人设功能让机器人能适配不同场景 —— 比如给家人用的暖心助手、给社群用的趣味问答机器人；不过初期使用时要注意，先熟悉基础的对话测试，再逐步添加插件，避免功能叠加导致卡顿，且扫码登录 后建议留存登录日志，方便排查异常。

接入 cpolar 解决局域网限制后，使用体验提升显著：之前只能在家用电脑调整机器人的 MCP 服务（如 12306 车票查询），现在通勤路上用手机就能修改参数，出差时也能远程给社群机器人更新节日自动回复；甚至可以把管理后台分享给异地的伙伴，协作调整机器人的插件权限，比如让朋友帮忙维护点歌插件的音源配置。摆脱局域网束缚后，机器人不再局限于 “固定地点使用”，无论是个人随时调整 AI 对话风格，还是小型团队协作管理社群机器人，都更灵活，真正实现了 “随时随地可用”。

这篇教程会带你用最简单的方式:只用一份 docker-compose,一次命令,5 分钟以内完成 AstrBot + NapCat 部署,把 DeepSeekAI 接入你的 。AstrBot 本身就是为 AI 而生的现代化机器人框架,插件丰富、支持 DeepSeek/OpenAI 等大模型、带 WebUI、可扩展性强,真正做到"搭好就能用"。照着做,你马上就能拥有属于自己的 AI 机器人。

1.1 AstrBot是什么？

GitHub 仓库：https://github.com/AstrBotDevs/AstrBot

AstrBot 是一个专为 AI 大模型设计的开源聊天机器人框架，它让你可以轻松地把 ChatGPT、DeepSeek、Claude 等 AI 接入到 、企业微信、Discord 等各种聊天平台。

核心特点：

• 🤖 原生支持主流 AI 模型：DeepSeek、OpenAI、Claude、GLM、通义千问等开箱即用
• 🔌 丰富的插件生态：天气查询、图片生成、语音合成、群管理等功能一键安装
• 🌐 多平台适配：支持 、频道、Discord、Telegram 等多个平台
• 🎯 开箱即用：提供 Docker 镜像和 WebUI 管理界面，无需复杂配置
• 📦 模块化设计：通过 OneBot 标准协议对接各类消息平台，扩展性强

简单来说，AstrBot 就是一个“AI 机器人中枢”，帮你把“AI 能力”和“聊天平台”连接起来，让你专注于功能本身，而不用操心底层实现。

1.2 NapCat 是什么？

仓库地址：https://github.com/NapNeko/NapCat

NapCat 是一个基于 NT（ 官方 Linux 版本）的 OneBot 协议实现框架，说人话就是：它能让你的 账号通过标准化接口被机器人程序调用。

在以前，大家常用的 go-cqhttp 已经停止维护，而 NapCat 作为新一代解决方案，具有以下优势：

核心特点：

• ✅ 稳定可靠：基于官方 Linux 版本，不是逆向激活成功教程，稳定性更好
• 🔄 持续维护：项目活跃开发中，及时跟进 版本更新
• 📡 标准协议：完整实现 OneBot v11 协议，兼容性强
• 🚀 功能完善：支持消息收发、群管理、文件传输、语音图片等全部常用功能
• 🐳 Docker 友好：官方提供 Docker 镜像，部署简单
• 🔐 安全登录：支持扫码登录，无需担心密码泄露

为什么要用 NapCat？

因为 本身不提供公开的 API 接口给开发者，而 NapCat 就像一个“翻译官”，把 的操作翻译成标准的 OneBot 协议接口，让 AstrBot 这样的机器人框架可以通过 HTTP/WebSocket 来控制你的 账号收发消息。

简单来说：NapCat 负责登录 并提供接口，AstrBot 负责处理逻辑和调用 AI，两者配合就能让你的 变成智能机器人。

本教程演示在Windows11操作系统上的Docker一键部署，部署方式在其他环境也一致。

安装好Docker以后，电脑键盘按快捷键Windows + R键，输入powershell回车，打开Windows PowerShell窗口，输入如下命令:

GPT plus 代充 只需 145

可以看到，命令执行了检查Docker及状态，创建文件夹，下载astrbot的docker-compose文件astrbot.yml，然后启动容器，以及输出容器的访问地址等。

如果是Linux部署，可以依次执行如下命令即可（官方命令）：

也可以执行如下Linux一键部署命令：

GPT plus 代充 只需 145

控制台提示部署好后，我们依次访问一下，首先访问Astrbot(访问的IP请查看控制台输出的IP，或者使用本地回环地址localhost也可以)：

可以发现，成功的访问到啦，接下来再试试访问NapCat：

GPT plus 代充 只需 145

好啦，都访问成功啦！

首先，在浏览器中打开如下地址，访问NapCat的web登录界面：

如果控制台日志清了，可以通过查看docker容器日志找到，输入如下命令进行查看：

GPT plus 代充 只需 145

接着，登录上你想要作为机器人的账号，可以选择侧边的扫码登录，登录完成后，会自动跳转到首页：

4.1 初始化AstrBot配置

输入AstrBot的访问地址，访问到AstrBot的Web登录界面：

输入用户名和密码astrbot，然后点击登录，登录成功后首次会提示修改账号信息，修改一下然后重新登录即可：

4.2 AstrBot关联NapCat

登录进来后，点击侧边的机器人，然后在页面点击创建机器人按钮，在弹出的窗口中，消息类别选择个人号，并且启用，保存即可：

保存弹出安全提醒的话，直接无视警告并继续创建即可（因为是在本地进行，所以也无需设置Token，当然也可以设置一下），创建好后，会有成功提示：

点击展开平台日志，然后用另一个账号给机器人账号发送消息测试，是否成功通信：

可以看到，成功的接收到了来自另一个账号发送的消息。

5.1 获取DeepSeek的Api密钥

首先，前往DeepSeek官网的用量信息页面，未登录会先跳转登录页面，登录即可，在该页面可以看到余额和消耗：

GPT plus 代充 只需 145

接着，点击API keys,进入该页面：

在页面上点击创建 API key的按钮，然后设置一个名称（用于辨识），创建完成后点击复制按钮进行复制（注意，只会显示一次，不用刻意记忆，忘记删除重新创建即可）：

好了，这样就获取到了deepseek的Api密钥了，留着备用。

5.2 将API密钥配置到AstrBot中

首先，在AstrBot的后台侧边栏点击模型提供商菜单，然后点击页面上的新增模型提供商按钮，在弹出的窗口中选择接入DeepSeek：

在配置页面中点击修改按钮，将前面获取到DeepSeek的API密钥填入其中，然后点击保存：

保存后，即可看到新增的模型提供商了，点击测试按钮，可以测试是否可用：

5.3 简单对话测试是否可用

可用看到，成功的回复响应了我们的提问。

这是因为AstrBot的默认人设给的提示词为：

这里提供一些收集到的人设，自行获取即可（人设全部为官方群获取，群友上传，非个人创建，个别人设可能有点…你懂的）：

GPT plus 代充 只需 145

创建好人格后，我们可以在对话框中直接输入指令进行查看和切换，输入如下指令,可以查看人格相关的指定：

接着，查看一下人格情景列表，看看之前在后台创建的人格设定是否能够查询到：

GPT plus 代充 只需 145

可以看到，成功的查询到了添加的人格设定，接着切换一个测试一下：

可以看到，现在就能够分段式的回复了。想要切换其他人设，同样使用如下命令切换即可，但是要注意上下文，所以一定要执行/reset清空上下文：

GPT plus 代充 只需 145

可以看到，成功的生效且分段回复啦，到这儿，人格设定创建和切换就搞定啦!

前面我们已经配置好了人设相关配置了，接下来我们来添加一些插件，让它支持更多功能。我们回到后台页面，点击插件侧边菜单栏，在插件市场中可以看到许多的插件：

在弹出的窗口中，可以选择使用GitHub加速，然后测试一下连通性，选择一个较低延迟的点击安装：

接着回到对话框发送指令测试一下：

可以看到成功的推送了这首歌的歌曲卡片给我，安装上了插件，就拥有了更多的玩法啦！

到这一步，你的 AI 机器人已经具备了基础对话能力和丰富的插件功能。但你可能会想：能不能让 AI 机器人更智能一点？比如自动查天气、查车票、搜索资料、执行复杂任务？这就是 MCP（Model Context Protocol，模型上下文协议） 要解决的问题。

8.1 什么是 MCP？

MCP 是一个由 Anthropic 提出的开放协议，它让 AI 模型能够通过标准化接口调用外部工具和服务。简单来说，MCP 就像给 AI 装上了"手和脚"，让它不再局限于纯文本对话，而是能主动调用工具、获取实时信息、执行具体操作。

而 AstrBot 正是支持 MCP 协议的机器人框架之一。通过配置 MCP 服务，你的 AI 机器人可以：

• ️ 实时查询天气、新闻、股票等信息
•  联网搜索最新资料并总结回复
• ️ 执行自定义工具，比如数据库查询、API 调用等
•  处理复杂任务，让 AI 自主选择合适的工具组合完成目标

接下来，我们就来看看如何在 AstrBot 中启用和配置 MCP 服务，让你的 AI 机器人真正"智能"起来。

8.2 安装Mpc服务

回到AstrBot后台页面，点击侧边菜单栏的MCP，然后点击页面上的同步服务器按钮，在弹出的窗口中点击蓝色字体ModelScope 平台,进行跳转：

即如下地址,以12306-mcp为例，点击进入：

GPT plus 代充 只需 145

进入后，点击滚动到下方，找到MCP服务器配置，点击复制按钮进行复制：

复制下来后，回到astrbot后台页面，点击新增服务器按钮，然后在弹出的窗口中设置一个服务器名称，服务器配置部分内容粘贴先前复制下来的mcp配置，最后点击测试，测试可用直接点击保存即可：

8.3 测试MCP服务

可以看到，完整的告诉了我普通的快速列车和高铁动车的相关车票信息，包含具体的列车号、出发时间、到达时间、座位及价格，完美的将12306的MCP服务接入进来啦！

到这一步,你的 AI 机器人已经跑得很完美了——能聊天、能切换人设、能调用插件、还支持 MCP 服务。但很快你就会发现一个问题：人在外面想调整配置?不行,必须连家里的局域网。机器人突然不回复了? 机器人直接"失联"。 这时候你会意识到,本地部署虽然简单,但"只能本地用"这个限制实在太致命。

不过转折就在这里：用 cpolar 做个内网穿透,几条命令搞定,你的 AstrBot 立刻拥有一个公网域名——这意味着你可以在地铁上用手机调机器人，切换API key相关操作,可以把管理面板发给异地的朋友访问查看。接下来,我们就用 cpolar 打通这"最后一公里"。

9.1 什么是cpolar?

• cpolar 是一款内网穿透工具，可以将你在局域网内运行的服务（如本地 Web 服务器、SSH、远程桌面等）通过一条安全加密的中间隧道映射至公网，让外部设备无需配置路由器即可访问。
• 广泛支持 Windows、macOS、Linux、树莓派、群晖 NAS 等平台，并提供一键安装脚本方便部署。

9.2 下载cpolar

下来下来是一个压缩包,解压后执行目录种的应用程序,一路默认安装即可,安装完成后,打开cmd窗口输入如下命令确认安装:

GPT plus 代充 只需 145

出现如上版本即代表安装成功!

9.3 注册及登录cpolar web ui管理界面

cpolar官网

访问cpolar官网，点击免费注册按钮，进行账号注册

注册完成后,在浏览器中输入如下地址访问 web ui管理界面:

输入刚才注册好的cpolar账号登录即可进入后台页面:

9.4 穿透AstrBot

9.4.1 随机域名方式(免费方案)

随机域名方式适合预算有限的用户。使用此方式时，系统会每隔 24 小时 左右自动更换一次域名地址。对于长期访问的不太友好，但是该方案是免费的，如果您有一定的预算，可以查看大纲9.4.2 的固定域名方式，且访问更稳定。

点击左侧菜单栏的隧道管理，展开进入隧道列表页面，页面下默认会有 2 个隧道：

• remoteDesktop隧道，指向3389端口，tcp协议
• website隧道，指向8080端口，http协议（http协议默认会生成2个公网地址，一个是http，另一个https，免去配置ssl证书的繁琐步骤）

点击编辑website的隧道，修改成我们AstrBot需要的信息：

接着，点击左侧菜单的状态菜单，接着点击在线隧道列表菜单按钮，可以看到有2个astrbot-6185的隧道，一个为http协议,另一个为https协议:

注意：每个用户创建的隧道显示的公网地址都不一样！

接下来在浏览器中访问astrbot-6185隧道生成的公网地址（http和https皆可），这里以https为例：

可以看到成功访问啦!

9.4.2 固定域名方式

通过前面的配置，我们已经成功实现了AstrBot的远程访问，但免费随机域名方案的局限性也逐渐显现：每24小时左右自动更换域名地址，意味着你需要频繁更新书签、重新分享链接，甚至可能因为忘记更新而无法访问。固定域名方案正是为了解决这些痛点而生，能够让你拥有一个永久不变的专属地址。

好啦，接下来开始固定保留二级子域名教程！

首先，进入官网的预留页面:

GPT plus 代充 只需 145

选择预留菜单，即可看到保留二级子域名项，填写其中的地区、名称、描述（可不填）项，然后点击保留按钮，操作步骤图如下：

列表中显示了一条已保留的二级子域名记录：

• 地区：显示为China Top。
• 二级域名：显示为astrbot。

注：二级域名是唯一的，每个账号都不相同，请以自己设置的二级域名保留的为主

接着，进入侧边菜单栏的隧道管理下的隧道列表，可以看到名为astrbot-6185的隧道，点击编辑按钮进入编辑页面：

修改域名类型为二级子域名，然后填写前面配置好的子域名，点击更新按钮：

来到状态菜单下的在线隧道列表可以看到隧道名称为astrbot-6185的公网地址已经变更为二级子域名+固定域名主体及后缀的形式了：

这里以https协议做访问测试（加载稍慢，需耐心等待一下）:

访问成功！这样一来，你就拥有了一个永久不变的专属域名，再也不用担心24小时域名更换的问题。

AstrBot+NapCat 的智能 机器人组合，在 cpolar 的加持下突破了网络环境限制，日常使用无需再依赖固定局域网，灵活适配多场景的远程管理需求，让智能助手的实用性大幅提升。