系统配置
Nekro Agent 提供了灵活的系统配置选项，让您可以根据自己的需求自定义系统行为。本文档将介绍完成基本聊天对话功能所需的主要系统配置项。
⚙️ 访问配置
通过 WebUI 配置 (推荐)
- 访问 WebUI：
http://<您的服务器IP>:8021 - 登录后进入「系统配置」→「基本配置」
注意：
- 修改配置项前请务必将鼠标悬停于配置项上
!图标查看配置项说明 (如果有)，这些说明往往提供了非常有用的配置项使用说明 - 配置修改后需要点击「保存」按钮才能生效
通过配置文件修改
注意
除非必要，否则不建议通过配置文件修改系统配置，若要进行修改请确保您完全了解 YAML 的基本语法，并深入理解配置项的含义，否则可能会导致系统无法正常运行
默认安装路径下，配置文件位于 ~/srv/nekro_agent/configs/nekro-agent.yaml
注意：直接修改配置文件后需要使用 /conf-reload 命令或重启 NA 服务才能生效
📝 概念
配置键
配置键是配置文件中用于标识配置项的唯一标识符，由 大写英文单词与下划线组成 你可以在 WebUI 的「系统配置」→「基本配置」页面所有配置名下方看到它，与配置文件中的索引键一一对应，例如 ENABLE_NEKRO_CLOUD 就是用来控制是否启用 NekroAI 云服务功能的配置键，以下必要配置项将以 <配置名> - [配置键] 的形式展示，你可以在页面上使用 Ctrl + F 搜索配置键来快速定位到对应的配置项
配置值
配置值是配置键对应的值，你可以在 WebUI 的「系统配置」→「基本配置」页面所有配置名下方看到它，与配置文件中的字段值一一对应，例如 ENABLE_NEKRO_CLOUD 的配置值为 true 表示启用 NekroAI 云服务功能
🔑 必要基本配置
在「系统配置」→「基本配置」页面中，以下配置项为必要配置项，务必进行配置
机器人 QQ 号 - [BOT_QQ]
机器人 QQ 号是用于配置作为 AI 对话机器人的 QQ 账号，务必与 NapCat 或其他协议端登陆的 QQ 账号一致
管理员账户 - [SUPER_USERS]
管理员账户是用于配置允许使用系统命令的账号，通常配置为管理员用户的 QQ 账号即可，可以配置多个；需要注意的是配置为管理员的 QQ 用户可以使用 QQ 账号+默认密码(123456) 登录 WebUI 进行管理操作，请务必在登陆后及时修改密码
🔒 必要模型组配置
在「系统配置」→「模型组」页面中，请至少配置一个可用的 LLM 对话模型组，否则将无法正常使用
为了方便用户快速上手配置，系统默认预置了来自 Nekro 合作中转站 的聊天、绘图、嵌入三个类型模型组配置，你可以直接前往 Nekro 合作中转站 注册账号后创建一个密钥分别填入即可开始使用 (新用户注册赠送 1 刀站点余额，可满足一些低频低成本模型的使用需求)，如果你有其他官方或非官方的 OpenAI 兼容接口模型渠道，可自行替换其中的 API 地址访问使用
更多模型
请前往 模型选择指南 查看更多模型的多维实测与推荐