←
GoClaw v2.24.0

Yield Mention Mode

Let multiple bots coexist in one Telegram group — each bot knows when to step back.

"Every bot is ready, but knows when to stay silent"
01 — Problem

"Everyone wants to answer"

Imagine 3 AI bots in one Telegram group: @writer_bot, @code_bot, and @research_bot. Before v2.24.0, you had only 2 bad choices:

ConfigBehaviorProblem
require_mention: falseBot responds to every messageAll 3 bots jump in to answer
require_mention: trueBot only responds when mentionedMust always type @bot_name — tedious
02 — Solution

Yield Mode

Rule: Respond to all messages, UNLESS someone is mentioning another bot/user.

AI

AI Workspace

3 bots, 5 members
You
Write me a product review for X
@writer_bot
I'll write the review for you...
@code_bot
I can help with technical analysis...
@research_bot
I found information about product X...

↑ No mention → all bots respond

AI

AI Workspace

3 bots, 5 members
You
@writer_bot write me a product review for X
@writer_bot
Sure, I'll write the review right away!
@code_bot
...
@research_bot
...

↑ Mention @writer_bot → only writer responds, others yield

03 — Decision Flow

Yield or respond?

Decision Flow
Message Received From another bot? yes Am I @mentioned? yes RESPOND no no (human) Any @mention in msg? none ALL RESPOND has @mention Mentions me? yes RESPOND no Mentions someone else? yes YIELD no RESPOND
04 — Configuration

One line of config

config.json5
{
  "channels": {
    "telegram": {
      "token": "BOT_TOKEN",
      "mention_mode": "yield",     // ← Bật yield mode
      "require_mention": false      // yield ghi đè setting này
    }
  }
}

Two modes

strict default

Follows require_mention. On = must mention, Off = respond to all.

yield NEW

Respond to all messages, yield when someone @mentions another bot/user.

Config Resolution Cascade

Channel

strict

→
Group

yield

→
Topic

strict

Topic > Group > Channel default

05 — Use Cases

Real-world use cases

Team AI Workspace

A group as "AI workspace" for the team. Everyone chats normally → all bots listen. Need deploy? @devops_bot deploy staging.

@assistant_bot@devops_bot@analytics_bot

Multi-language Support

Two language bots. Both respond by default. Want only Vietnamese? @vi_bot explain this.

@en_bot@vi_bot

AI Meeting Room

Group discussion where all bots contribute opinions. Need specific input: mention directly.

06 — Upgrade

Get started now

Zero migration

No database migration needed. Just update config or enable on Web UI: Channels → Telegram → Group Response Behavior → "Multi-bot".

terminal
git pull origin main
go build -o goclaw .
# Thêm mention_mode: "yield" vào config
# Hoặc cấu hình trên Web UI
VI EN ZH JA