nekro-agent

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

开源 🏷️定价信息待确认 ✅ 目前可打开对话助手 🍴 复刻 89 🐛 待处理 32 👀 关注 9

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1165

维护状态维护中

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

nekro-agent 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类对话助手

开发团队KroMiose

官网地址https://nekro.ai

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

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议NOASSERTION

主要语言Python

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

GitHub 星标★ 1165

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

代码更新2026-10-09

仓库体积11.5 MB

本站数据更新2026-11-08

维护状态维护中

收录时间2026-08-09

浏览次数4

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1165

技术标签

agent ai chatbot claudecode openai

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：进阶约 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 命令。