配置概述

ChatAI 插件提供灵活的配置系统，支持全局配置、群组配置和用户配置。

配置层级

全局配置 → 群组配置 → 用户配置

低层级配置会覆盖高层级配置。

配置方式

Web 管理面板

推荐使用 Web 面板进行配置：

#ai管理面板

面板提供可视化配置界面，修改实时生效。

配置文件

配置文件位于 plugins/chatai-plugin/config/config.yaml

配置模块

模块	说明	文档
基础配置	命令前缀、调试模式	基础配置
渠道配置	API 渠道、重试机制	渠道配置
模型配置	模型选择与参数	模型配置
触发配置	触发方式与条件	触发配置
上下文配置	对话上下文管理	上下文配置
记忆配置	长期记忆系统	记忆配置
MCP 配置	MCP 服务器接入	MCP 配置
代理配置	网络代理设置	代理配置
前端配置	Web 管理面板	前端配置

配置文件结构

# 基础配置
commandPrefix: "#"
debug: false

# 触发配置
trigger:
  private: prefix
  group: at
  prefix: "#chat"

# 渠道配置
channels:
  - name: default
    baseUrl: https://api.openai.com/v1
    apiKey: sk-xxx
    model: gpt-4o

# 上下文配置
context:
  maxMessages: 20
  cleaningStrategy: sliding

# 记忆配置
memory:
  enabled: true
  maxMemories: 1000

# MCP 配置
mcp:
  enabled: true

# 内置工具配置
builtinTools:
  enabledCategories:
    - basic
    - user

环境变量

敏感信息可以使用环境变量：

channels:
  - name: openai
    apiKey: ${OPENAI_API_KEY}

支持的环境变量：

变量	说明
OPENAI_API_KEY	OpenAI API 密钥
ANTHROPIC_API_KEY	Claude API 密钥
GOOGLE_API_KEY	Gemini API 密钥
HTTP_PROXY	HTTP 代理地址

配置热重载

修改配置后，无需重启即可生效：

#ai重载配置

配置备份

建议定期备份配置：

cp config/config.yaml config/config.yaml.bak

配置迁移

从旧版本迁移时，插件会自动合并新增配置项。

下一步

• 基础配置 - 了解基础配置选项
• 渠道配置 - 配置 API 渠道