KroMiose/nekro-agent

NekroAgent 是一个面向多人互动场景的跨平台 Agent 框架,集 Claude Code 沙盒执行、工作区编排、长期记忆、结构化 MCP 管理与可视化控制台于一体,兼具高扩展性、多模态交互、实时状态推送和自动化运行能力。项目支持 QQ、Discord、Telegram、Minecraft、BilibiliLive、WeChat、Email、SSE(SDK) 等多种平台接入,应用于构建高智能聊天机器人,可扩展为具备代码执行、工具调用、插件协作和复杂任务处理能力的通用 Agent 系统

해결하는 문제

Nekro Agent는 대규모 언어 모델(LLM)과 실제 세계의 상호작용 플랫폼 사이의 격차를 메우기 위해 설계된 매우 확장 가능한 AI 봇 프레임워크입니다. 이는 AI 에이전트가 실제로 코드를 실행하여 작업을 수행하고, 장기 기억을 유지하며, Discord, Telegram, QQ와 같은 여러 채팅 플랫폼을 통합 인터페이스를 통해 상호작용할 수 있도록 하는 문제를 해결합니다.

작동 방식

시스템은 플랫폼별 어댑터(예: Minecraft 또는 Bilibili용)가 통신을 처리하고, 핵심 엔진이 비즈니스 로직을 관리하는 입력/출력 스트림 아키텍처를 사용합니다. 복잡한 작업을 수행하려면 에이전트가 AI에게 코드를 생성하게 하여 보안이 강화된 컨테이너 기반 사전에서 실행합니다. 또한 장기적 맥락을 위한 메모리 시스템을 포함하고, 구조화된 외부 도구 관리를 위한 Model Context Protocol (MCP)을 지원합니다.

대상 사용자

  • 봇 개발자: 최소한의 설정으로 고도화된 AI 에이전트를 구축하고 배포하고자 하는 사람
  • 커뮤니티 관리자: 그룹 채팅에 AI 어시스턴트를 통합하여 정서적 동반자 역할이나 작업 자동화를 원하는 사용자
  • 파워 유저: 다양한 플랫폼에서 파일과 이미지를 처리할 수 있는 다중 모달 AI 어시스턴트가 필요한 개인

주요 특징

  • 보안 코드 실행: 컨테이너 기반 사전에서 AI가 생성한 코드를 안전하게 실행하여 메서드 수준의 확장성을 보장합니다.
  • 다중 플랫폼 지원: OneBot v11, Discord, Telegram, Minecraft, Bilibili Live, WeChat, Email용 네이티브 어댑터 제공.
  • 장기 기억: 엔티티-관계 매핑과 벡터 검색 기능을 갖춘 미리보기 시스템으로 지속적인 맥락을 유지합니다.
  • 통합 웹 UI: 에이전트의 동작을 모니터링하고 설정을 구성할 수 있는 포괄적인 시각적 관리 패널.
  • MCP 통합: 레지스트리와 카드 기반 인터페이스를 통해 외부 도구 및 MCP 서비스를 구조화된 방식으로 관리합니다.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트