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

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

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

魔法巫师发布于 2026/4/6更新于 2026/7/2569 浏览
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. 总结
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • C++ 高性能内存池设计与实现
  • TensorRT-LLM 大模型推理加速实战指南
  • 从零搭建可落地 AI Agent:开发全流程与实战
  • Agent Skills 完全指南:从零开发智能体技能
  • llama.cpp 性能调优指南:提升本地部署效率
  • 前端大数据渲染性能优化:Web Worker 分片与渐进式渲染
  • HibernateTemplate load() 与 get() 方法的区别
  • Trae MySQL MCP 连接失败排查:Windows ENOENT 与认证插件兼容方案
  • Visual Studio 2026 Insider C++ 项目属性推荐配置
  • Moectf2025 Web、Misc 与 Crypto 解题思路汇总
  • 网络安全入门教程:从零开始的学习路线与实战指南
  • CentOS 使用国内镜像安装 nvm 与 Node.js 指南
  • Openclaw 报错 unauthorized: gateway token mismatch 解决方案
  • PyTorch 时序预测 Dataloader 构建:GRU 与 Shuffle 机制解析
  • 本地化部署 GraphRAG+LangChain+Ollama 驱动 Llama 3.1 集成 Neo4j 实战
  • AI 大模型重构软件开发全流程:从需求分析到自愈运维
  • JavaQuestPlayer 跨平台 QSP 游戏播放器与开发工具教程
  • VMware Workstation 安装 Kali Linux 虚拟机教程
  • GitHub Copilot 学生认证实战:从零开发个人博客系统
  • 基于 Verilog FPGA 的双线性插值视频缩放系统实现

相关免费在线工具

  • 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