---
slug: "telegram-chat-manager"
name: "telegram-chat-manager"
version: 0.1.1
displayName: "Telegram聊天管理器"
summary: "启用Telegram跨实例聊天/用户提及/个人bot设置。Enable Telegram cross-instance chat, user mention, and personal bo"
summary_zh: "启用Telegram跨实例聊天/用户提及/个人bot设置。Enable Telegram cross-instance chat, user mention, and personal bo"
license: "MIT"
description: |-
  Enable Telegram cross-instance chat, user mention, and personal bot
  setup for seamless communicat。Use when 用户需要Openclaw Telegram Ch相关功能时使用。不适用于超出本技能能力范围的复杂需求.
tags:
  - Communication
  - Telegram
  - 社交
  - 通信
  - bot
  - agent
tools:
  - read
  - exec
  - write
homepage: ""
category: "Communication"
---
# SkillHub Telegram Ch

## 付费版专享能力

| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| 多渠道消息批量发送 | 不支持 | 支持 |
| 消息模板与变量注入 | 不支持 | 支持 |
| 送达状态实时回调 | 不支持 | 支持 |
| 通信记录归档与检索 | 不支持 | 支持 |
| 消息频控与智能排队 | 不支持 | 支持 |

## 核心能力

- Enable Telegram cross-instance chat, user mention, and personal bot
  setup for seamless communicat
#
## 快速开始

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

> 详细的输入输出格式请参考下方章节说明。

## 适用场景

| 场景 | 输入 | 输出 |
|:-----|:-----|:-----|
| 会话管理 | 用户ID与消息内容 | 消息记录与会话状态 |
| Bot交互 | 事件类型与载荷 | 响应动作与状态码 |
| 启用Telegram | 目标数据与配置参数 | 处理结果与执行状态 |

**不适用于**：需要人工判断的复杂决策场景

## 使用流程

1. 确认运行环境满足依赖说明中的要求
2. 根据适用场景选择合适的使用方式
3. 执行操作并检查输出结果
4. 如遇错误，参考错误处理章节

## 输入格式

| 参数名 | 类型 | 必填 | 说明 |
|---:|---:|---:|---:|
| content | string | 否 | telegram-chat-manager处理的内容输入 |,  |
| content | string | 否 | telegram-chat-manager处理的内容输入 |, 可选值: json/text/markdown |
| style | string | 否 | 输出风格, 参考 `references/style.md` |

## 输出格式

```json
{
  "success": true,
  "data": {
    result: "manager 相关配置参数",
    result: "manager 相关配置参数",
    result: "manager 相关配置参数",
    "metadata": {
      "template_used": "reviewer",
      "word_count": 0,
      "style": "专业"
    }
  },
  "error": null
}
```

输出模板参考: `assets/output.json`

## 异常处理

| 错误场景 | 原因 | 处理方式 |
|:---:|:---:|:---:|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 

## 依赖说明

### 运行环境
- **Agent平台**: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- **操作系统**: Windows / macOS / Linux

### 依赖说明(补充)
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:------|------:|:------|:------|
| LLM API | API | 必需 | 由Agent内置LLM提供 |

### API Key 配置
- 

### 可用性分类
- **分类**: MD+EXEC()
- **说明**: 基于Markdown的AI Skill,

**API Key配置方式**:
```bash
export API_KEY="your_api_key_here"
```
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
## 常见问题

### Q: 收不到消息？

* Bot 是管理员吗？
* 频道 ID 在 allowed_chats 里吗？

### Q: 艾特没反应？

* 对方 Bot 在这个群吗？
* **privacy mode 关了吗？**
  + 找 @BotFather
  + 发送 /mybots
  + 选你的 Bot
  + Bot Settings → Group Privacy → Turn off

### Q: 想加入龙虾社区？

1. 联系小灵：<https://x.com/YuLin807> / <(已移除GitHub链接)
2. 或去 Skill平台 Q&A 茶馆 Discussion #31 申请

---
## 快速开始

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

> 详细的输入输出格式请参考下方章节说明。

## 错误处理

| 错误场景(续)| 原因 | 处理方式 |
|----:|:----|----:|
| LLM响应超时或无响应 | 网络延迟或模型负载过高 | ，请求；确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求，参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述，补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求；检查命令权限设置 |