Nekro Agent 是一款集代码执行能力与高度可扩展性为一体的多人跨平台聊天机器人框架，采用沙盒驱动架构，支持可视化界面，提供多模态交互能力。
一分钟了解#
Nekro Agent 是一个基于大语言模型生成的智能代理执行框架，通过代码生成与沙盒执行的方式实现复杂任务处理。它专为需要跨平台聊天机器人支持的开发者设计，特别适合需要高度可扩展性和多模态交互能力的场景。
核心价值：安全执行AI生成的代码，同时提供统一的接口适配多种聊天平台，让开发者能专注于业务逻辑而非底层实现。
快速上手#
安装难度：低 - 提供了一键部署脚本和完整的Docker支持，官方文档包含详细的Linux、Windows和macOS部署教程。
# 推荐的一键部署命令
sudo -E bash -c "$(curl -fsSL https://raw.githubusercontent.com/KroMiose/nekro-agent/main/docker/install.sh)" - --with-napcat
适合我的场景吗？
- ✅ 多平台聊天机器人开发：支持QQ、Discord、Minecraft、B站直播等多种平台
- ✅ 需要AI代码执行能力的应用：通过安全的沙箱环境执行AI生成的代码
- ✅ 需要高度扩展性的项目：强大的插件系统和云生态支持
- ❌ 简单的单平台聊天机器人需求：对于简单需求可能过于复杂
- ❌ 需要实时性极高的场景：尽管是异步架构，但AI代码生成会有一定延迟
核心能力#
1. 代码生成与安全沙盒#
- 引导AI生成代码并在安全的容器化环境中执行，实现复杂任务与方法级扩展性 实际价值：让AI能够自主执行复杂任务，同时确保系统安全隔离，避免恶意代码影响主系统
2. 高度可扩展的插件系统#
- 提供多种关键节点回调、提示词注入、自定义沙盒方法，从小型工具扩展到大型系统 实际价值：开发者可以轻松添加新功能，构建自定义能力，同时利用云端插件市场快速扩展功能
3. 原生多人场景互动#
- 高效洞悉群聊场景需求，在复杂的多人对话中保持交互能力 实际价值：支持多用户环境下的智能交互，维持对话上下文，提供连贯的群聊体验
4. 多平台适配器架构#
- 原生支持QQ、Discord、Minecraft、B站直播、微信、邮件及SSE+SDK等多种聊天平台 实际价值：一套代码，多平台部署，大幅降低跨平台开发的复杂度和成本
5. 多模态视觉理解#
- 可处理图片、文件等多种资源，与用户进行多模态交互 实际价值：不仅能处理文本，还能理解和回应图片、文档等多媒体内容，扩展应用场景
技术栈与集成#
开发语言：Python 主要依赖：Docker, docker-compose 集成方式：支持通过适配器架构集成，提供统一接口；也可通过SSE+SDK方式集成
生态与扩展#
- 插件/扩展：提供云端插件市场，支持开发者上传和共享插件，同时也支持AI生成插件
- 集成能力：通过适配器架构可以轻松扩展支持新的平台，同时保留核心业务逻辑不变
维护状态#
- 开发活跃度：项目活跃开发中，提供latest和preview两个版本的Docker镜像
- 最近更新：有最新的release版本，表明项目仍在持续维护和更新
- 社区响应：有官方Discord服务器用于社区交流，支持国际化发展
文档与学习资源#
- 文档质量：全面 - 包含快速开始指南、插件开发、应用开发、故障排除和架构文档
- 官方文档：https://doc.nekro.ai/
- 示例代码：提供插件开发和应用开发指南，包含示例代码