快速开始
欢迎使用 Nekro Agent (以下简称 NA)
!本文档将帮助您快速开始使用这个强大的 AI 代理系统。
⚠ 安全警告 ⚠
本项目运行时允许 AI 在独立 Docker 容器环境中执行任意代码,应用已采用多种包括但不限于容器隔离、权限限定等安全措施,但仍存在一定的安全风险,例如:
- IP 地址泄漏
- 容器逃逸
- 其它未知风险
! 请知悉结果接受自行承担风险后继续,作者不对使用本项目造成的任何损失负责 !
部署选择
根据您的操作系统选择合适的部署方式:
- Linux 部署教程 - 适用于各类 Linux 发行版
- Windows 部署教程 - 适用于 Windows 10/11 系统
- MacOS 部署教程 - 适用于 MacOS 系统
基本配置
成功部署后,您需要完成以下基本配置:
- 协议端配置:连接到您选择的聊天平台
- 模型配置:设置 AI 模型及 API 密钥
- 系统配置:设置基本系统参数和用户权限
详细配置说明请参考以下文档:
首次使用
访问管理界面
完成部署后,您可以通过以下地址访问管理界面:
http://<您的服务器IP>:8021
(远程访问)http://localhost:8021
(本地访问)
登录管理界面
首次登录时,请使用部署过程中生成的管理员账户和密码进行登录
基本使用流程
- 连接协议端:完成协议端配置并确认连接状态
- 设置人设:配置 AI 的基本人设和行为模式
- 测试对话:通过您选择的平台与 AI 进行对话测试
- 扩展功能:按需启用所需的扩展功能
下一步
完成基础配置后,您可以探索更多高级功能:
- 模型组配置 - 配置多种模型组合
快速参考
常用管理命令
bash
# 查看 NA 容器日志
sudo docker logs -f nekro_agent
# 查看 NapCat 容器日志
sudo docker logs -f nekro_napcat
# 重启服务
sudo docker restart nekro_agent
常用聊天指令
/na-info - 显示当前应用信息
/na-help - 显示帮助信息
/reset - 重置当前会话
💡 功能探索
好奇 Nekro Agent 能做什么?查看 应用场景展示 了解丰富多样的实际使用案例和创意玩法!