nekro-agent

一个框架，让聊天机器人会写代码、记性好、多平台跑起来

NekroAgent 是一个面向多人互动场景的跨平台 Agent 框架，旨在解决多用户环境下聊天机器人的智能化与可扩展性问题。它集成了 Claude Code 沙盒执行环境，允许 Agent 安全地运行代码；提供工作区编排能力，可管理复杂任务流程；内置长期记忆机制，让 Agent 记住用户偏好和历史对话；支持结构化 MCP 管理，方便接入外部工具和数据源；并配有可视化控制台，便于监控和配置。项目支持 QQ、Discord、Telegram、Minecraft、BilibiliLive、WeChat、Email、SSE 等多种平台接入，可构建高智能聊天机器人，并扩展为具备代码执行、工具调用、插件协作和复杂任务处理能力的通用 Agent 系统。基于 Python 开发，拥有活跃的社区和成长中的星标数。

开源 unknown 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1127

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类对话助手

开发团队KroMiose

所属国家

官网地址https://nekro.ai

GitHubhttps://github.com/KroMiose/nekro-agent

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议NOASSERTION

主要语言Python

技术栈/模型agent,ai,chatbot,claudecode,multiuserchat,openai,python,sandbox

GitHub 星标★ 1127

30天Star增速

HF 下载量

上线时间2024-07-26 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：进阶约 15 分钟部署方式：Docker 6 步

环境要求

已安装 Docker 环境（能执行 docker pull）
可访问 Docker Hub 或 GitHub Container Registry (GHCR)
按官方文档准备目标聊天平台的接入配置（QQ / Discord / Telegram 等）
准备好可用的 LLM 服务 API Key（如 OpenAI）

安装与启动步骤

1查看快速开始文档

README 未给出完整安装命令，所有部署细节以 doc.nekro.ai 的快速开始文档为准，先通读再动手。
2选择部署教程

按操作系统选择对应教程：Linux、Windows、MacOS 三份部署文档，步骤与依赖各不相同。
3拉取稳定版镜像

从 Docker Hub 拉取 latest 标签，基于正式 tag 发布，适合生产环境使用。
```
docker pull kromiose/nekro-agent:latest
```
4拉取预览版镜像

如需体验最新功能，可改用 preview 标签，由 main 分支自动构建，仅适合测试与开发。
```
docker pull kromiose/nekro-agent:preview
```
5GHCR 备选拉取

若 Docker Hub 拉取缓慢或失败，可改用 GitHub Container Registry 的等价镜像地址。
```
docker pull ghcr.io/kromiose/nekro-agent:latest
```
6启动并接入平台

镜像拉取后需按官方文档启动容器并配置平台接入与模型参数，README 未提供具体 run 命令。

如何确认成功

执行 docker images，若列表中出现 kromiose/nekro-agent 及对应 latest 或 preview 标签，说明镜像已拉取成功。

常见问题

Q：latest 和 preview 有什么区别？

A：latest 是稳定版本，基于 tag 发布，适用于生产环境；preview 是预览版本，每次 main 分支更新自动构建，包含最新功能，适合测试和开发。

Q：镜像应该从哪里拉取？

A：Docker Hub 与 GitHub Container Registry (GHCR) 同时发布同样标签，优先推荐 Docker Hub；拉取不畅时可换用 ghcr.io/kromiose/nekro-agent。

Q：拉取镜像后怎么启动？

A：README 未给出 docker run 命令，请按操作系统打开官方 Linux / Windows / MacOS 部署教程，照文档完成启动与配置。

Q：一键部署脚本在哪里？

A：README 提到推荐使用一键部署脚本，但节选中脚本内容为空，请到 doc.nekro.ai 的快速开始文档获取最新脚本。

Q：支持接入哪些聊天平台？

A：支持 QQ、Discord、Telegram、Minecraft、BilibiliLive、WeChat、Email、SSE 等多种平台，具体接入步骤见官方文档。

注意事项

README 节选中未提供完整的 docker run 启动命令与端口、卷映射参数，请以官方文档为准，不要自行猜测。
一键部署脚本在 README 节选中内容缺失，建议直接访问 doc.nekro.ai 获取最新版本。
项目提供 NekroAI 云社区（cloud.nekro.ai），可共享插件与人设，但需自行确认其使用条款。
遇到问题可加入官方 QQ 群 636925153 或 Discord 频道求助。

核心亮点

内置 Claude Code 沙盒，Agent 可直接执行代码并返回结果，适合编程类问答
支持 8+ 平台接入，覆盖主流社交和游戏平台，扩展性强
长期记忆机制让 Agent 在多轮对话中保持上下文，提升交互连贯性

不足之处

文档/社区待观察
依赖外部 AI 服务（如 Claude），可能产生 API 成本

适用场景

搭建多平台智能客服或社区机器人
开发可执行代码的编程助手（如 Discord 机器人）
构建带记忆的虚拟角色或游戏内 NPC

替代项目

LangChain、AutoGPT、Dify

项目介绍

nekro-agent 是智能体领域的开源项目，由 KroMiose 开发，2024 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,127）位列前 30%，在智能体分类中处于中上游。

近 45 天，它的 GitHub 星标从 1,082 增加到 1,127，净增 45。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：搭建多平台智能客服或社区机器人。同类可对比的替代方案包括 LangChain、AutoGPT、Dify。

上一篇：flock

下一篇：tribe