超可爱猫娘 AI 机器人｜NAS 一键部署 QQ 群聊自动陪聊

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 问题，我也折腾了很久）

等下载完成，就能正常启动运行了

使用

浏览器中输入 http://NAS的IP:8021 就能看到界面

输入账号和密码（默认用户名 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 代理框架，安全、高效、优雅的智能交互体验）

使用体验：⭐⭐⭐（功能丰富，可扩展性强）

部署难易：⭐⭐⭐（一般）︎