Trigger Configuration Triggers

Configure how users activate AI conversations.

Trigger Types

Type	Description	Example
at	@mention the bot	@bot hello
prefix	Command prefix	#chat hello
keyword	Contains keyword	ai help me
random	Random probability	Any message (5% chance)
always	Always respond	Every message

Configuration

Basic Config

trigger:
  # Private chat trigger
  private: always
  
  # Group chat trigger
  group: at
  
  # Command prefix (for prefix mode)
  prefix: "#chat"

Multiple Triggers

trigger:
  group:
    - at
    - prefix
  prefix: "#ai"
  keywords:
    - "帮我"
    - "请问"

Private Chat

Mode	Behavior
always	Respond to all messages
prefix	Only respond to prefixed messages
none	Disable private chat

Group Chat

Mode	Behavior
at	Respond when @mentioned
prefix	Respond to prefixed messages
keyword	Respond when keywords detected
random	Random chance to respond
atAll	Respond to @all

Keyword Trigger

trigger:
  group: keyword
  keywords:
    - "ai"
    - "机器人"
    - "帮我"
  keywordMode: contains  # or "startsWith", "exact"

Random Trigger

trigger:
  group: random
  randomRate: 0.05  # 5% chance

Per-Group Override

groups:
  123456789:
    trigger:
      mode: prefix
      prefix: "#gpt"
  987654321:
    trigger:
      mode: at

Web Panel

Configure triggers visually:

1. Go to Groups tab
2. Select a group
3. Configure trigger settings
4. Save

Priority

When multiple triggers are enabled:

1. Prefix trigger (highest)
2. @mention trigger
3. Keyword trigger
4. Random trigger (lowest)

Next Steps

• Presets - AI personas
• Group Config - Group settings