Nekro Agent：
一个面向多人互动场景的跨平台 Agent 框架，集 Claude Code 沙盒执行、工作区编排、长期记忆、结构化 MCP 管理与可视化控制台于一体，兼具高扩展性、多模态交互、实时状态推送和自动化运行能力。项目支持 QQ、Discord、Telegram、Minecraft、BilibiliLive、WeChat、Email、SSE(SDK) 等多种平台接入，应用于构建高智能聊天机器人，可扩展为具备代码执行、工具调用、插件协作和复杂任务处理能力的通用 Agent 系统
核心能力：
- • 安全的容器化 沙盒执行环境，内置完整的 Python 运行时环境
- • 强大的代码 引导、生成、纠错、执行 能力，支持图表生成、通用内容处理等复杂任务
- • 原生多模态 视觉理解与交互 支持，可处理图片、文件等多种资源
- • 高度可扩展的 插件系统，提供多种关键节点回调、提示词注入、自定义沙盒方法
- • 原生的 多人场景互动 支持，高效洞悉群聊场景需求
- • 云端实时资源共享服务，包括插件、人设等，强大友好的 社区驱动 能力
- • 功能齐全的 可视化界面 应用管理面板
- • 拒绝无效提示词与滥用迭代智能体，复杂任务的极致 降本增效 实践
- • 基于 事件驱动 的交互架构，遵循异步优先的高效响应机制
- • 支持动态安装与 实时引入 PYPI 依赖，解锁 Python 宇宙的无尽矿藏
TIP：折腾了两天还是不清楚哪里有问题，目前情况就是可以接收到 QQ 发过来的信息，也可以回复，但是对接机器人自动回复有问题，好像找不到消息通道 ID 报错。
安装
Docker Compose
services:
# PostgreSQL 服务
nekro_postgres:
image: postgres:14
container_name: nekro_postgres
environment:
POSTGRES_USER: nekro_user
POSTGRES_PASSWORD: nekro_password
POSTGRES_DB: nekro_agent
volumes:
- ./srv/nekro_postgres_data:/var/lib/postgresql/data
restart: unless-stopped
# Qdrant 服务
nekro_qdrant:
image: qdrant/qdrant
container_name: nekro_qdrant
environment:
- QDRANT__SERVICE__API_KEY=6d9d2f3e-5f8c-4b7a-8e4d-2e6f4b7a8e4d
volumes:
- ./srv/nekro_qdrant_data:/qdrant/storage
restart: unless-stopped
# 主服务
nekro_agent:
image: kromiose/nekro-agent:latest
container_name: nekro_agent
environment:
- NEKRO_DATA_DIR=/srv/nekro_agent
- NEKRO_EXPOSE_PORT=8021
- NEKRO_POSTGRES_HOST=nekro_postgres
- NEKRO_POSTGRES_PORT=5432
- NEKRO_POSTGRES_USER=nekro_user
- NEKRO_POSTGRES_PASSWORD=nekro_password
- NEKRO_POSTGRES_DATABASE=nekro_agent
- NEKRO_RUN_IN_DOCKER=true
- NEKRO_ADMIN_PASSWORD=admin_strong_password
- ONEBOT_ACCESS_TOKEN=3d9d2f3e-5f8c-4b7a-8e4d-2e6f4b7a8e4e
- NEKRO_QDRANT_URL=http://nekro_qdrant:6333
- NEKRO_QDRANT_API_KEY=6d9d2f3e-5f8c-4b7a-8e4d-2e6f4b7a8e4d
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- ./srv/nekro_agent:/srv/nekro_agent:rw
depends_on:
- nekro_postgres
- nekro_qdrant
ports:
- 8021:8021
restart: unless-stopped
参数说明（更多参数建议去看文档）
:::POSTGRES_USER（环境变量）：设置管理员用户名
POSTGRES_PASSWORD（环境变量）：设置管理员密码
POSTGRES_DB（环境变量）：设置数据库名称
NEKRO_ADMIN_PASSWORD（环境变量）：访问界面的密码
8021（端口）：访问界面的端口
:::
注意启动容器以后，还需要自动下载东西（普通网络就行，不过因为 DNS 问题，我也折腾了很久）
等下载完成，就能正常启动运行了
使用
浏览器中输入 <span leaf="">http://NAS的IP:8021</span> 就能看到界面
输入账号和密码（默认用户名 admin ，密码是前面环境变量设置的 admin_strong_password）
成功进入面板，说实话功能还是挺多的。虽然官方也有文档说明，但真不知道从哪里开始上手。
模型管理
系统配置 -》 模型管理，先配置模型（可以添加新模型，我是直接修改原来的配置）
目前支持国内好几家模型厂商，我用的是智谱的作为测试
设置好以后，记得点击连通测试一下
CC 模型组也可以同样配置一下
适配器
接下来设置适配器，我对接的是 QQ 机器人（需要额外部署 NapCat 容器进行联动）
按要求填写下面信息
设置正确之后，就可以在下面显示 NapCat 的界面了
下面需要去到 NapCat 里新建一个 Websocket 客户端（也能在上面窗口直接配置）
首先点击启动和填写名称
URL 按实际情况填写，注意链接的格式
ws://<你的服务器IP>:8021/onebot/v11/ws
Token 填写刚才在 Nekro Agent 页面里看到的 OneBot 服务访问密钥
保存配置后，来到容器日志应该没有显示报错信息的
QQ 向机器人账号发送一条私信，可以在系统日志里看到信息，说明已经配置连接成功
点击机器人头像，会自动跳转到当前聊天频道
可以在这里切换身份和直接发送信息回复
不过我不清楚哪里设置问题，调用机器人就会提示聊天频道不存在，后面就没折腾了
总结
Nekro Agent 是一款很火的跨平台智能交互框架，主打互动场景，集成了代码沙盒、长期记忆和可视化面板，支持 QQ、Discord 及直播接入。不得不说扩展性是真的强，很适合做直播回复，微信和 QQ 聊天机器人。不过上手还是有一定难度的，虽然网上有很多人介绍安利，但实际上手的教程很少，我自己折腾几天还是有问题。有兴趣的用户可以试试，说实话还是很不错的。
综合推荐：⭐⭐⭐（新一代 AI 代理框架，安全、高效、优雅的智能交互体验）
使用体验：⭐⭐⭐（功能丰富，可扩展性强）
部署难易：⭐⭐⭐（一般）︎
