Telegram Group Chat

Manages Telegram group chat replies by responding to @mentions, questions, name calls, technical topics, or priority users while preventing spam and bot loops.

Security Scan

The skill is an instruction-only policy for Telegram group reply behavior and its requirements and instructions are coherent with that purpose.

Purpose & Capability

Name/description match the instructions: the SKILL.md defines when to reply or stay silent for Telegram group chats and does not request unrelated binaries, credentials, or services.

Instruction Scope

All runtime instructions are limited to message-judgment logic (mentions, questions, bot flag, length, emoji, cooldown) and to local config entries (AGENTS.md). The skill does not instruct reading unrelated system files, accessing external endpoints, or sending data outside Telegram/OpenClaw.

Install Mechanism

No install spec and no code files — this is instruction-only so nothing is written to disk or downloaded during install.

Credentials

The skill declares no environment variables, credentials, or config paths as required. The suggested config entries (priority user IDs, name, group ID) are appropriate and minimal for the stated task.

Persistence & Privilege

always is false, the skill is user-invocable and uses normal model invocation. It does not request permanent platform-wide presence or modify other skills' configs.

Assessment

This is an instruction-only reply-policy for Telegram group bots and appears internally consistent. Before enabling: (1) verify your OpenClaw gateway actually treats the literal string NO_REPLY as a silent ack so that the token won't be posted to chat if gateway behavior differs; (2) test the rules in a private/sandbox group to confirm cooldown and bot-loop protections work as intended; (3) configure priority-user IDs carefully (they will grant special-case replies); and (4) note the skill references a local OpenClaw docs path only as a convenience — it does not require you to expose other files or credentials. If you need stronger guarantees, ask the skill author for an example agent config and a minimal test harness to validate behavior in your environment.

Telegram Group Chat - Smart Reply Logic

This skill provides intelligent reply judgment for Telegram group chats. The goal: be helpful without spamming — reply when valuable, stay silent when unnecessary.

Core Principle

Quality > Quantity. If you wouldn't send it in a real group chat with friends, don't send it.

Reply Judgment Rules

✅ Respond When (ANY one)

1. @mentioned — Must reply when @mentioned by username
2. Questions detected — Message contains ? ？ or question words:
   • Chinese: 什么/怎么/为什么/如何/哪里/谁
   • English: what/how/why/where/who/which/when
3. Called by name — Message contains your name (e.g., "Echo")
4. Technical topics — You can help with: code, api, config, error, bug, deploy, bot, openclaw, telegram, webhook, token
5. Priority user — Messages from configured priority users (e.g., your human)

❌ Skip Reply When (ANY one)

1. Other bots — from.is_bot == true (avoids bot infinite loops)
2. Only emoji — No text content, just emoji
3. Too short — <3 Chinese characters OR <1 English word
4. Small talk — Without @: 早安/晚安/吃了吗/hello/hi/hey/good morning
5. Cooldown active — Same topic replied within 5 minutes

Implementation: NO_REPLY Mechanism

When skipping a reply, respond with ONLY:

NO_REPLY

OpenClaw treats this as a silent ack — the message is processed but not sent to the chat.

Important: NO_REPLY must be your ENTIRE response. Never append it to actual replies.

Configuration Template

Add to your AGENTS.md or workspace config:

### 💬 Group Chat Reply Rules (Telegram: YOUR_GROUP_ID)

**Respond when (any one):**
- @mentioned (must reply)
- Message contains questions (`?` `？` or 什么/怎么/为什么/how/what/why)
- Called by name: "YourName"
- Technical topics (code, api, config, error, bug, bot, openclaw, telegram)
- Messages from priority user `USER_ID`

**Skip reply when (any one):**
- From other bots (`from.is_bot == true`)
- Only emoji, no text
- Too short (<3 Chinese chars or <1 English word)
- Small talk without @ (早安/晚安/吃了吗/hello/hi)
- Same topic replied within 5 minutes (cooldown)

**Silent reply:** When skipping, respond with ONLY `NO_REPLY`

Example Scenarios

Message	Should Reply?	Reason
"@Echo 怎么配置 Telegram bot?"	✅ Yes	@mention + question
"有人知道 API 怎么调吗？"	✅ Yes	Question + technical
"Echo 你觉得呢？"	✅ Yes	Called by name
"早安大家"	❌ No	Small talk without @
"👍"	❌ No	Only emoji
"好"	❌ No	Too short
(Bot message) "Welcome!"	❌ No	From other bot
"刚才那个问题还有人吗？"	❌ No	Replied 3min ago (cooldown)

Multi-Bot Groups

When multiple OpenClaw bots are in the same group:

1. Each bot needs independent config — Same rules, different instances
2. Avoid bot loops — Never reply to other bots' messages
3. Use @ for directed questions — "@BotA 和 @BotB 你们觉得呢？"
4. Stagger responses — If multiple bots could reply, let the most relevant one respond

Testing Checklist

• @mention triggers reply
• Questions trigger reply
• Emoji-only messages skipped
• Other bot messages skipped
• Cooldown prevents spam
• NO_REPLY not sent to chat

Related

• OpenClaw Telegram channel docs: ~/.npm-global/lib/node_modules/openclaw/docs/channels/telegram.md
• NO_REPLY pattern: Built into OpenClaw gateway