Basic Configuration Setup

Essential configuration after installation.

Configuration Methods

Web Panel (Recommended)

#ai管理面板

Visual interface, changes apply immediately.

Config File

Edit config/config.yaml directly.

Essential Settings

1. Add API Channel

channels:
  - name: main
    baseUrl: https://api.openai.com/v1
    apiKey: ${OPENAI_API_KEY}
    model: gpt-4o

Environment Variables

Store API keys in environment variables for security:

export OPENAI_API_KEY=sk-xxx

2. Set Trigger Mode

trigger:
  private: always     # Respond to all private messages
  group: at          # Require @mention in groups
  prefix: "#chat"    # Optional prefix trigger

3. Configure Masters

masters:
  - "123456789"      # Your QQ number

Verify Configuration

Test your setup:

#ai状态

You should see:

• ✅ Channel connected
• ✅ Model available
• ✅ Tools loaded

Quick Config Examples

Minimal Setup

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

trigger:
  private: always
  group: at

With Proxy

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

proxy:
  enabled: true
  type: http
  host: 127.0.0.1
  port: 7890

Multiple Channels

channels:
  - name: openai
    baseUrl: https://api.openai.com/v1
    apiKey: ${OPENAI_API_KEY}
    model: gpt-4o
    priority: 1
    
  - name: deepseek
    baseUrl: https://api.deepseek.com
    apiKey: ${DEEPSEEK_API_KEY}
    model: deepseek-chat
    priority: 2

Reload Config

After editing config file:

#ai重载配置

Next Steps

• Channels - Multi-channel setup
• Presets - AI personas
• Triggers - Trigger configuration