群聊智能体 NekroAI/nekro-nxt

NekroNXT：把 DeepSeek Harness 带到即时通讯

简体中文 · English · 使用文档 · 下载正式版

NekroNXT 是 NekroAI 开发的群聊智能体系统。它把智能体接入你正在使用的即时通信平台。智能体面对的是群聊里持续发生的多人对话，可以理解上下文、使用工具并参与协作。

💬 为真实群聊而设计

用一套方式连接不同即时通信平台

平台适配器负责登录账号、收发消息和发现频道。你可以把同一个智能体绑定到多个群聊，也可以为不同群聊安排不同智能体。安装新的适配器后，仍按账号、频道和智能体的顺序完成连接。

跟得上多人对话

每个群聊拥有独立的消息记录和会话上下文。群成员可以通过提及或预设规则触发智能体。系统先记录工具执行期间到达的新消息，再把这些内容交给智能体的下一步思考。每个群聊只读取自己的短期上下文。

由 DSH 提供智能体运行内核

DSH 负责智能体的思考循环、工具执行、会话持久化、上下文压缩、模型接入和扩展运行。NekroNXT 负责即时通信接入、频道管理、消息投递记录和产品界面。

✨ 还能做什么

- 长期管理智能体：分别设置人设、模型、权限、频道和扩展；
- 确认每次发送：文字、提及、图片和文件都由通信工具投递，界面显示实际发送结果；
- 连接多个群聊：一个智能体可以服务多个频道，每个频道的会话彼此隔离；
- 给智能体增加能力：工具、平台适配器、模型供应商和界面组件都通过扩展安装；
- 让智能体参与创造：描述需求、运行新能力、查看验证结果、保存为本地扩展，再选择使用它的智能体；
- 选择合适的运行方式：桌面版适合个人电脑，服务端适合长期在线和远程管理。

🖼️ 产品画面

NekroNXT 中的多人频道会话、消息与运行过程

截图仅供界面示意参考。

🚀 立即开始

桌面版：下载后直接使用

桌面版已经带上运行环境。下载对应平台的安装包，打开应用后配置模型即可开始。

| 支持平台 | 客户端下载 |
| macOS | 下载 NekroNXT |
| Windows | 下载 NekroNXT |
| Linux | 下载 NekroNXT |

查看桌面版安装说明

服务端：用 Docker 长期运行

把 <管理密钥> 替换为至少 32 个字符的随机字符串，把 <持久化目录> 替换为宿主机上的数据目录：

docker run -d \
--name nekro-nxt \
--restart unless-stopped \
-p 127.0.0.1:4960:4960 \
-e NEKRO_MANAGEMENT_KEY='<管理密钥>' \
-v '<持久化目录>:/data' \
ghcr.io/nekroai/nekro-nxt:latest

启动后用浏览器打开 http://127.0.0.1:4960，输入管理密钥登录。

查看网页登录、公网访问、Docker Compose 与备份说明

三步开始使用

1. 在「设置 → 模型供应商」填写 API Key 并选择模型；
2. 创建一个智能体，设置名称、人设和可用能力；
3. 先在内置频道对话，或前往「连接」添加即时通信账号、选择群聊并绑定智能体。

完整步骤见快速开始。

📚 文档与社区

| 目标 | 入口 |
| 安装、配置并开始对话 | 快速开始 |
| 连接即时通信平台与群聊 | 连接频道 · QQ 官方机器人 · OneBot V11 |
| 配置模型、智能体和扩展 | 模型 · 智能体 · 扩展 |
| 部署、升级、备份或排障 | 服务端部署 · 升级与备份 · 常见问题 |
| 参与开发 | 贡献指南 · 贡献者文档 |
| 反馈问题 | 支持说明 · GitHub Issues |
| 社区交流 | NekroAI 官方 QQ 群 636925153 |

当前状态

NekroNXT 已提供正式版，同时保留由 main 完整 CI 自动更新的 Preview。创建智能体、群聊接入、频道对话和扩展创造的主流程已经跑通；平台适配与升级恢复仍在继续完善。

安全问题请按安全策略私密报告。社区交流遵循行为准则。

软件代码以 GNU AGPL v3.0（SPDX：AGPL-3.0-only）授权，扩展开发用的 contracts、extension-format、extension-sdk 与 adapter-sdk 四个包以 MIT 授权；品牌与角色素材不属于该授权范围，使用边界见品牌规范和 NOTICE。

Copyright © 2026 NekroAI contributors.