跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashAI

AstrBot+NapCat 一键部署智能 QQ 机器人及 cpolar 公网访问

演示了如何通过 Docker 一键部署 AstrBot 和 NapCat 搭建智能 QQ 机器人。内容涵盖项目介绍、环境配置、DeepSeek AI 接入、人设切换、插件安装及 MCP 服务扩展。最后通过 cpolar 内网穿透实现公网访问管理后台,提供完整的本地化 AI 机器人搭建方案。

魔法巫师发布于 2026/4/6更新于 2026/10/25141 浏览
AstrBot+NapCat 一键部署智能 QQ 机器人及 cpolar 公网访问

AstrBot+NapCat 一键部署智能 QQ 机器人及 cpolar 公网访问

本教程演示如何使用 Docker 一键部署 AstrBot + NapCat,将 DeepSeek AI 接入 QQ。AstrBot 是专为 AI 大模型设计的开源聊天机器人框架,NapCat 是基于 NTQQ 的 OneBot 协议实现。

1. 项目介绍

1.1 AstrBot 是什么?

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

AstrBot 是一个专为 AI 大模型设计的开源聊天机器人框架,支持将 ChatGPT、DeepSeek、Claude 等 AI 接入到 QQ、企业微信、Discord 等平台。

核心特点:

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

1.2 NapCat 是什么?

仓库地址:https://github.com/NapNeko/NapCatQQ

NapCat 是一个基于 NTQQ(QQ 官方 Linux 版本)的 OneBot 协议实现框架,能让 QQ 账号通过标准化接口被机器人程序调用。

核心特点:

  • 稳定可靠:基于官方 QQ Linux 版本
  • 持续维护:项目活跃开发中
  • 标准协议:完整实现 OneBot v11 协议
  • Docker 友好:官方提供 Docker 镜像

2. 使用 Docker 一键部署 AstrBot + NapCat

本教程演示在 Windows 11 操作系统上的 Docker 一键部署,Linux 环境部署方式类似。

2.1 Windows 部署

打开 PowerShell 窗口,输入如下命令:

irm https://gitee.com/jun-wan/script/raw/master/astrbot/deploy_astrbot.ps1 | iex 

命令执行后会自动检查 Docker 状态、创建文件夹、下载 docker-compose 文件并启动容器。

2.2 Linux 部署

依次执行如下命令:

mkdir astrbot
cd astrbot
wget https://raw.githubusercontent.com/NapNeko/NapCat-Docker/main/compose/astrbot.yml
sudo docker compose -f astrbot.yml up -d

或者执行一键部署命令:

curl -fsSL https://gitee.com/jun-wan/script/raw/master/astrbot/deploy_astrbot.sh | bash

部署完成后,访问以下地址:

  • AstrBot: http://localhost:6185
  • NapCat: http://localhost:6099

3. 配置 NapCat

  1. 访问 http://localhost:6099/。
  2. 查看控制台日志获取 Token:
    docker logs napcat | Select-String "Token"
    
  3. 在登录页面输入 Token 进行登录。
  4. 选择扫码登录,登录你想要作为机器人的 QQ 账号。

4. 配置 AstrBot 关联 NapCat

4.1 初始化 AstrBot 配置

访问 http://localhost:6185,默认用户名和密码为 astrbot。首次登录需修改账号信息。

4.2 关联 NapCat

  1. 点击侧边栏机器人,点击创建机器人。
  2. 消息类别选择QQ 个人号,启用后保存。
  3. 测试通信:用另一个 QQ 账号给机器人发送消息。

5. 配置 DeepSeek 接入 AstrBot

5.1 获取 DeepSeek API 密钥

前往 DeepSeek 官网用量信息页面,创建 API key 并复制。

5.2 配置 API 密钥

  1. 在 AstrBot 后台点击模型提供商 -> 新增模型提供商。
  2. 选择接入 DeepSeek,填入 API 密钥并保存。
  3. 点击测试验证可用性。

5.3 对话测试

发送消息测试 AI 回复是否正常。

6. 更换人设和配置文件修改

默认人设为助手模式,可通过后台创建新的人格设定。

  1. 进入更多功能 -> 人格设定,点击创建人格。
  2. 输入人格 ID 和系统提示词。
  3. 在对话框中使用指令切换:
    /persona <ID>
    /reset
    
  4. 启用流式回复以获得分段回复体验。

注意:文中提及的人设资源链接已移除,请自行寻找合适的人设提示词。

7. AstrBot 插件功能

  1. 点击插件侧边栏,进入插件市场。
  2. 搜索并安装所需插件(如点歌插件)。
  3. 安装后可在对话框使用对应指令测试。

8. AstrBot 的 MCP 服务

MCP(Model Context Protocol)允许 AI 调用外部工具和服务。

8.1 安装 MCP 服务

  1. 在 AstrBot 后台点击MCP -> 同步服务器。
  2. 跳转至 ModelScope 平台获取配置 JSON。
  3. 粘贴配置并保存测试。

8.2 测试 MCP 服务

询问 AI 关于车票等信息,验证是否成功调用外部服务。

9. 使用 cpolar 实现公网访问

本地部署的服务无法在外网访问,可通过 cpolar 内网穿透解决。

9.1 下载与安装 cpolar

访问 cpolar 官网下载对应系统的安装包,安装后确认版本:

cpolar version

9.2 注册及登录

注册账号后,访问 http://127.0.0.1:9200 登录 Web UI 管理界面。

9.3 配置隧道

9.3.1 随机域名方式
  1. 进入隧道管理 -> 隧道列表。
  2. 编辑现有隧道或新建隧道,指向 AstrBot 端口(如 6185)。
  3. 获取生成的公网地址访问。
9.3.2 固定域名方式
  1. 在官网预留二级子域名。
  2. 在隧道管理中修改域名类型为二级子域名,填写预留名称。
  3. 更新后获得永久不变的专属地址。

总结

本文介绍了从零搭建基于 AstrBot + NapCat 的 QQ AI 机器人,实现了 DeepSeek 智能对话、人设切换、插件扩展及 MCP 服务增强。通过 cpolar 内网穿透实现了公网访问,满足远程管理和随时在线的需求。

目录

  1. AstrBot+NapCat 一键部署智能 QQ 机器人及 cpolar 公网访问
  2. 1. 项目介绍
  3. 1.1 AstrBot 是什么?
  4. 1.2 NapCat 是什么?
  5. 2. 使用 Docker 一键部署 AstrBot + NapCat
  6. 2.1 Windows 部署
  7. 2.2 Linux 部署
  8. 3. 配置 NapCat
  9. 4. 配置 AstrBot 关联 NapCat
  10. 4.1 初始化 AstrBot 配置
  11. 4.2 关联 NapCat
  12. 5. 配置 DeepSeek 接入 AstrBot
  13. 5.1 获取 DeepSeek API 密钥
  14. 5.2 配置 API 密钥
  15. 5.3 对话测试
  16. 6. 更换人设和配置文件修改
  17. 7. AstrBot 插件功能
  18. 8. AstrBot 的 MCP 服务
  19. 8.1 安装 MCP 服务
  20. 8.2 测试 MCP 服务
  21. 9. 使用 cpolar 实现公网访问
  22. 9.1 下载与安装 cpolar
  23. 9.2 注册及登录
  24. 9.3 配置隧道
  25. 9.3.1 随机域名方式
  26. 9.3.2 固定域名方式
  27. 总结

更多推荐文章

查看全部
  • 基于 LangChain 与 CAMEL 框架开发智能 Agent 实战
  • GitHub Copilot 接入 Claude Code 本地技能的自动化映射方案
  • Python + AI 智能害虫识别助手
  • Spring 拦截器与统一响应异常处理实战
  • HarmonyOS NEXT 华为账号一键登录与 UnionID 身份体系构建
  • Spring Boot 核心架构与自动配置原理深度解析
  • 2026 年高校 AIGC 检测升级下的论文降重工具选型指南
  • SQL Server 2025 安装教程
  • 前端监控实战:构建可观测的 Web 应用
  • Wave Terminal 跨平台终端工具安装与使用指南
  • 多模态大模型:技术原理与实战指南
  • Vue 3 核心面试题与实战解析
  • KoboldAI 本地部署与配置指南
  • 2026 主流 AI Agent 框架横评:OpenClaw 及衍生版对比与选型指南
  • Linux 45 个高效命令技巧集锦
  • SDXL Prompt Styler:AI 绘画风格控制与提示词工程优化方案
  • FPGA 摄像头采集处理显示指南:OV5640 至 HDMI 实时显示
  • object-browser 核心功能解析:文件上传、版本控制与权限管理
  • AI 大模型的预训练、迁移与中间件编程技术解析
  • VSCode 配合 Git 实现代码仓库回滚实战

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online