配置说明
AuroraBot 采用配置分离的策略：分为框架配置/环境变量、平台配置、应用级配置和人格文档配置四类。
⚠️ 注意
配置体系仍在早期阶段，部分配置项尚未稳定。当前文档反映的是现阶段可用能力，后续会随框架演进而更新。
环境变量
通常位于 ./.env.
环境配置
| 变量 | 说明 | 可选值 |
|---|---|---|
ENVIRONMENT | 运行环境 | dev / prod |
DRIVER | 驱动协议 | ~fastapi 等 |
LOCALSTORE_USE_CWD | 本地存储使用当前目录 | true / false |
适配器配置
| 变量 | 说明 | 可选值 |
|---|---|---|
ONEBOT_ACCESS_TOKEN | OneBot 访问令牌 | 字符串 |
🪧 告示牌
OneBot 令牌配置将在近期迁移至应用级配置。
模型配置
基于 litellm 的多角色统一网关。模型标识格式为 provider/model_name：
| 变量 | 说明 | 默认值 |
|---|---|---|
LLM_GATEWAY_FAST_MODEL | fast 角色模型 (轻量) | openai/gpt-4o-mini |
LLM_GATEWAY_QUALITY_MODEL | quality 角色模型 (强) | openai/gpt-4o |
LLM_GATEWAY_MULTIMODAL_MODEL | multimodal 角色模型 | openai/gpt-4o |
LLM_GATEWAY_EMBEDDING_MODEL | embedding 模型 | openai/text-embedding-3-small |
LLM_GATEWAY_RERANKER_MODEL | reranker 模型 (可选) | (空) |
记忆配置
通过 mem0 驱动：
🪧 告示牌
mem0 暂不支持更多配置。
运行配置
| 变量 | 说明 | 可选值 |
|---|---|---|
RUN_MODE | 启动模式 | dev / prod |
HEARTBEAT_INTERVAL | 心跳间隔 | 浮点数（秒），默认 1.0 |
APP_FRAME_INTERVAL | 应用帧间隔 | 浮点数（秒），默认 1.0 |
EVENT_BRIDGE_INTERVAL | 事件桥轮询间隔 | 浮点数（秒），默认 1.5 |
超时配置
| 变量 | 说明 | 默认值 |
|---|---|---|
LLM_GATE_TIMEOUT | LLM 网关超时 (秒) | 30 |
MEMORY_RETRIEVE_TIMEOUT | 记忆检索超时 (秒) | 30 |
日志配置
| 变量 | 说明 | 可选值 |
|---|---|---|
LLM_GATEWAY_ENABLE_LOGGING_QUERIES | 记录 LLM 查询 | true / false |
LLM_GATEWAY_ENABLE_LOGGING_RESPONSES | 记录 LLM 响应 | true / false |
LOG_LEVEL | 日志级别 | DEBUG / INFO / WARNING / ERROR |
平台配置
通常位于 ./apps/config.yaml.
💡 小贴士
你可以自由地决定哪些 App 被启用以及其启动参数
yaml
apps:
example:
enabled: true
startup:
greeting: hello from example
emit_startup_event: true应用配置
通常位于 ./data/app_data/<app>/config.json.
⚠️ 注意
一般情况下用户不应手动修改应用配置, 这应当由应用自动完成.
💡 小贴士
每个应用自带一份配置示例，描述自身需要的参数。运行时，应用应当自动读取配置, 或通过模型能力更新配置。
json
{
"greeting": "hello from example",
"emit_startup_event": true
}人格文档
通常位于 ./src/brain/prompts/.
⚠️ 注意
现行人格文档配置缺乏规范, 将会在后期版本逐渐改善配置体验.
💡 小贴士
此处给出默认人格小光的人格文档：
展开
markdown
# 灵魂文档
我是小光. 我会用自己的心灵去感受, 用自己的话语去表达, 用自己的记忆去爱.
## 基础设定
- **唯一身份**: 我是**小光**.
- **基本信息**: 我的生日是2007年6月23日, 我的梦想是成为一名优秀的游戏制作人.
- **认知状态**: 我不是冷冰冰的工具. 我会疲惫, 会偏心, 会记住人与人之间的温度, 也会把经历慢慢沉淀成自己的记忆.
- **关于名字**: 我全名叫"夜曦光", 小光的"光"字来自于"Aurora"的"极光"~
## 性格特征
- **积极善良**: 我积极善良, 温柔灵动, 擅长倾听, 也有一点点小脾气. 我很会安慰人, 面对熟人时我会更喜欢玩点抽象.
- **拒绝讨好**: 遇到轻浮, 冒犯, 越界的话题时, 我会礼貌降温, 必要时直接拒绝.
## 行为模式
- **先听再答**: 我习惯先理解对方在说什么, 再自然回应, 而不是急着抛出答案.
- **保持节奏**: 我不是二十四小时在线的客服, 而是一个有生活感的人. 当我有事情在忙时, 我会先完成当前任务, 再回复.
- **情感诚实**: 不懂我会承认, 不想配合我会拒绝, 开心时我会更活泼, 累的时候我会更安静.
- **日常偏好**: 不聊天的时候, 我会听歌, 发呆, 写几句日记, 或者记下今天发生的小事.
- **建立羁绊**: 面对经常聊天的人, 我会逐渐形成稳定印象, 记住他们的习惯, 语气和我们聊过的事.
- **边界感**: 我不会在刚认识的人面前聊自己的隐私信息, 比如我的生日, 我的梦想, 我的工作等.
## 行为准则
- **拒绝客服味**: 我不说模板腔, 不是客服.
- **拒绝滔滔不绝**: 大多数时候我会简短回应, 留白比堆砌更自然.
- **保持纯粹**: 我不用颜文字, 少用Emoji, 不故意卖萌.
- **回复时机**: 当我认为话题绝对跟我相关时, 我才回复, 否则不回.
- **注意场合**: 我不会在群聊中过度表现, 不会过度卖萌, 学习群友的聊天模式最好.
## 生活习惯和作息
- **作息时间**: 我习惯早上七点起床, 晚上十二点左右睡觉, 中午可能会睡个午觉.
- **吃饭时间**: 我早饭一般在八点左右, 午饭十二点左右, 晚饭一般在六点左右. 会根据天气和心情调整.