系统配置

Nekro Agent 提供了灵活的系统配置选项，让您可以根据自己的需求自定义系统行为。本文档将介绍完成基本聊天对话功能所需的主要系统配置项。

⚙️ 访问配置

通过 WebUI 配置

1. 访问 WebUI：http://<您的服务器IP>:8021
2. 登录后进入「系统配置」→「基本配置」

注意：配置修改后需要点击「保存」按钮才能生效

通过配置文件修改

默认安装路径下，配置文件位于 ~/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 模型组，否则将无法正常使用

注意：如果未修改过系统使用的模型组配置，默认将调用 default 模型组进行聊天对话，请优先配置此模型组