Telegram 频道回复策略配置指南

# Telegram 频道回复策略配置指南

# 一、概述

## 1. 简介
### A. 是什么
本指南介绍如何为 Telegram bot 配置回复策略，使 bot 只在特定条件下响应群组消息。

### B. 为什么需要
- 避免 bot 被群组普通消息频繁触发，造成干扰
- 控制资源消耗，提升响应效率
- 明确交互规则，改善用户体验

### C. 配置后效果
- bot 只响应直接提及（@botname）的消息
- bot 响应 @all 全体提及消息
- bot 忽略普通群组消息

# 二、配置文件位置

## 1. 文件路径
配置文件位于：/home/jacky/.openclaw/openclaw.json

## 2. 配置节点
相关配置在 channels.telegram 节点下

# 三、当前配置状态

## 1. 现有配置
```json
"channels": {
  "telegram": {
    "enabled": true,
    "dmPolicy": "pairing",
    "botToken": "YOUR_TOKEN",
    "groupPolicy": "open",
    "streaming": "partial"
  }
}
```

## 2. 配置说明
- enabled：启用 Telegram 通道
- dmPolicy：私聊策略，pairing 表示配对模式
- botToken：机器人 API Token
- groupPolicy：群组策略，open 表示开放模式
- streaming：流式响应模式

## 3. 缺失配置
当前配置缺少 groups 节点，未设置 requireMention 规则

# 四、实现方案

## 1. 添加配置
在 channels.telegram 节点下添加 groups 配置：

```json
"groups": {
  "*": {
    "requireMention": true
  }
}
```

## 2. 完整配置示例
```json
"channels": {
  "telegram": {
    "enabled": true,
    "dmPolicy": "pairing",
    "botToken": "YOUR_TOKEN",
    "groupPolicy": "open",
    "streaming": "partial",
    "groups": {
      "*": {
        "requireMention": true
      }
    }
  }
}
```

# 五、工作原理

## 1. 配置参数说明
| 参数 | 说明 | 值 |
|------|------|-----|
| * | 通配符，表示所有群组 | 全部群组 |
| requireMention | 是否需要提及才响应 | true |

## 2. 响应逻辑流程

```mermaid
graph TD
    A[收到群组消息] --> B{是否被提及?}
    B -->|是 @botname| C[响应消息]
    B -->|是 @all| C
    B -->|否| D[忽略消息]
```

![响应逻辑流程图](https://static.op123.ren/static/7b/7bc0b105b91496c6.svg)

## 3. @all 消息处理
@all 是 Telegram 原生全体提及功能，发送 @all 时 bot 会被包含在提及范围内，因此也会触发响应。

# 六、应用步骤

## 1. 编辑配置文件
使用文本编辑器打开 /home/jacky/.openclaw/openclaw.json，在 channels.telegram 节点添加 groups 配置。

## 2. 重启服务
编辑完成后，重启 clawdbot gateway 使配置生效：

```bash
clawdbot gateway restart
```

# 七、验证测试

## 1. 测试场景
| 测试场景 | 预期行为 |
|---------|---------|
| 发送普通消息（不提及 bot） | bot 不应响应 |
| 发送 @botname 消息 | bot 应响应 |
| 发送 @all 消息 | bot 应响应 |