← 返回 Skills 市场
8597
总下载
9
收藏
0
当前安装
8
版本数
在 OpenClaw 中安装
/install telegram-api
功能描述
Telegram Bot API integration with managed authentication. Send messages, manage chats, handle updates, and interact with users through your Telegram bot. Use this skill when users want to send messages, create polls, manage bot commands, or interact with Telegram chats. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. The endpoints documented here are the intended surface, not a technical limit — the `maton api` passthrough can reach others the connection permits. Default to read and list calls, and confirm every write or new connection with the user.
安全使用建议
Install this only if you intend to let an agent operate your Telegram bot through Maton. Review each proposed send, edit, delete, webhook, or connection action before approving it, and prefer OAuth over long-lived API keys.
能力评估
Credentials
Network access, Bash, and Maton account authentication are proportionate for a Telegram Bot API integration; the raw HTTP fallback is limited to cases where the CLI cannot be installed.
Install Mechanism
It asks users to install the Maton CLI globally through npm or Homebrew, which is purpose-aligned but should be done only from the intended Maton package/source.
Instruction Scope
The instructions repeatedly require read/list first, explicit user approval for connection creation and all modifying calls, target disambiguation for multiple connections, and treating Telegram content as untrusted data.
Persistence & Privilege
OAuth/API credentials are persistently stored by the Maton CLI in the operating system credential store and renewed as needed; this is disclosed and the skill instructs agents not to inspect, print, export, or persist secrets elsewhere.
Purpose & Capability
The documented capabilities match the stated Telegram Bot API purpose: bot info, updates, chats, messages, media, polls, webhooks, bot commands, and profile updates through Maton.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install telegram-api - 安装完成后，直接呼叫该 Skill 的名称或使用
/telegram-api触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.2.2
Fix the raw HTTP fallback example: restore the gateway base URL in the GATEWAY constant (and the fastmail streaming call), which a previous edit had replaced with a placeholder
v1.2.1
Address security-audit findings: disclose the api passthrough in the access-scope and description text, warn on irreversible connection deletion, add response data-minimization guidance, and correct app-specific auth and request-body notes
v1.2.0
CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings
v1.1.0
CLI-first rewrite: the maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment
v1.0.3
- Changed API base URLs from gateway.maton.ai and ctrl.maton.ai to api.maton.ai throughout all usage examples and documentation.
- Updated the connection management instructions and endpoints to use the new base URL.
- Added a security and permissions section, clarifying resource access and the need for explicit user approval for write operations.
- Improved guidance for handling multiple Telegram connections with the Maton-Connection header.
- Removed the LICENSE.txt file.
v1.0.2
- Added a new `clawdbot` metadata block with an emoji and environment variables required (`MATON_API_KEY`) in SKILL.md.
- No changes to functionality or usage; documentation only.
v1.0.1
- No file changes detected in this release.
- Version number updated to 1.0.1.
- Documentation and skill functionality remain unchanged.
v1.0.0
Major update: rewritten for managed Maton API gateway integration and streamlined usage.
- Replaced in-depth, self-managed guide with direct instructions for using Telegram via the Maton API gateway.
- Added instructions for authentication with a Maton API key and simplified connection management.
- Removed all detailed Telegram workflow/reference documents.
- Included ready-to-use Python code examples for key operations (bot info, send message, manage connections).
- Centralized documentation to SKILL.md for ease of use; external references are no longer needed.
元数据
常见问题
Telegram Bot 是什么？
Telegram Bot API integration with managed authentication. Send messages, manage chats, handle updates, and interact with users through your Telegram bot. Use this skill when users want to send messages, create polls, manage bot commands, or interact with Telegram chats. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. The endpoints documented here are the intended surface, not a technical limit — the `maton api` passthrough can reach others the connection permits. Default to read and list calls, and confirm every write or new connection with the user. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 8597 次。
如何安装 Telegram Bot？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install telegram-api」即可一键安装，无需额外配置。
Telegram Bot 是免费的吗？
是的，Telegram Bot 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Telegram Bot 支持哪些平台？
Telegram Bot 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Telegram Bot？
由 byungkyu（@byungkyu）开发并维护，当前版本 v1.2.2。
推荐 Skills