Telegram数据接入

技能简介

telebiz-mcp-skill 通过 MCP 协议连接 telebiz-tt 浏览器客户端，实现 Telegram 数据的程序化访问。支持列出聊天列表、读取消息内容、搜索历史记录、管理文件夹分类以及发送消息等操作。

能做什么

• 浏览和管理 Telegram 聊天会话（列表、归档、置顶、静音）
• 收发消息与转发内容，支持 Markdown 格式
• 按关键词或时间范围搜索消息历史
• 创建和管理聊天文件夹，批量整理会话
• 获取群组/频道成员信息

使用说明

前置条件：Node.js 18+ 环境，已注册 Telegram 账号。

步骤一：安装 MCP 服务

npm install -g @telebiz/telebiz-mcp

步骤二：启动浏览器端

访问 https://telebiz.io 并登录 Telegram 账号。

步骤三：启动本地 HTTP 服务

cd ~/clawd/skills/telebiz-mcp
./start-http.sh

该脚本在后台保持浏览器连接，并在 9718 端口暴露 HTTP API。

步骤四：启用 MCP 连接

在 telebiz.io 页面进入「Settings → Agent → Local MCP」，状态显示「Connected」即表示连接成功。

步骤五：验证可用性

npm run health

预期输出包含 Relay 运行状态、Executor 连接状态及可用工具数量（31 个）。

输入与输出

见下方输入与输出表格。

风险提示

• 速率限制较紧：单次请求最多 20 次调用，每分钟上限 30 次，调用间隔不少于 500ms，重载操作需间隔 1 秒
• batchAddToFolder 存在已知缺陷，批量添加聊天至文件夹时请改用循环调用 addChatToFolder
• linkEntityToChat 功能不稳定，测试中 company 与 organization 类型均出现过校验失败，建议暂不使用
• deleteChat、deleteMessages、deleteFolder 为不可逆操作，执行前请确认目标
• 测试产生的临时文件夹和群组请及时清理

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/acastellana/telebiz-mcp-skill/SKILL.md
来源类型：GitHub 仓库