← 返回 Skills 市场
Telegram Group Moderation
作者
Xavier Mary
· GitHub ↗
· v0.9.0
· MIT-0
239
总下载
0
收藏
0
当前安装
5
版本数
在 OpenClaw 中安装
/install telegram-group-moderation
功能描述
Moderate Telegram groups with a bot by receiving message/webhook events, extracting text/caption/media context, applying anti-advertising and anti-contact po...
安全使用建议
This package is an integration skeleton that will forward Telegram updates and message content to an external moderation endpoint and perform Telegram API actions using a bot token. Before installing or enabling it: 1) Confirm the source repository and review the example scripts yourself. 2) Do not supply real production secrets until you audit the code. The examples require TELEGRAM_BOT_TOKEN and MODERATION_CORE_ENDPOINT (and optionally MODERATION_CORE_TOKEN, TELEGRAM_WEBHOOK_SECRET, etc.), but the registry metadata doesn't declare these — expect to set them as environment variables. 3) Ensure the moderation endpoint is trusted (you are intentionally sending message text, chat_id, user_id, and related metadata). 4) Use a test Telegram bot and a test group with dry-run enabled first; restrict allowed_chat_ids and allowed hosts in configuration. 5) If you plan to run this in production, prefer storing tokens in a secrets manager, enable webhook secret verification, and move offense storage to Redis/DB rather than local files. If you need higher assurance, ask the publisher to update the package metadata to declare required env vars and runtime binaries and to provide a release provenance (signed release or known GitHub release) before deployment.
功能分析
Type: OpenClaw Skill
Name: telegram-group-moderation
Version: 0.9.0
The telegram-group-moderation skill bundle is a well-structured integration layer for connecting Telegram bots to a moderation policy engine. It provides clear architectural guidance and multi-language implementation examples (Python, Go, Java) for handling webhooks, normalizing message data, and executing moderation actions like deleting messages or banning users. The code follows security best practices by utilizing environment variables for sensitive tokens (TELEGRAM_BOT_TOKEN) and implementing webhook secret validation, with no evidence of malicious intent, data exfiltration, or harmful prompt injection.
能力标签
能力评估
Purpose & Capability
The skill's name, description, and bundled examples consistently implement a Telegram webhook -> moderation-core -> Telegram-action integration layer, which is coherent with the declared purpose. However the registry metadata omits key runtime requirements (no declared env vars or primary credential) even though the SKILL.md and example scripts clearly need bot tokens and moderation endpoint credentials.
Instruction Scope
SKILL.md and the example scripts stay within the stated scope (normalize Telegram updates, call an external moderation core, map results to actions and log). They direct the agent to POST message content and metadata to an external moderation endpoint and to call the Telegram API using a bot token. This is expected for an integration layer, but the instructions require transmitting message content and identifiers to an external endpoint (MODERATION_CORE_ENDPOINT) — make sure that endpoint is trusted and that you consent to sending this data.
Install Mechanism
No install spec is provided (instruction-only plus example scripts), so nothing will be automatically downloaded or executed by an installer. Example code is bundled (Python/Go/Java), which is low-risk from an install vector perspective but means you should review and run examples yourself rather than relying on an installer.
Credentials
The skill uses multiple sensitive environment variables in its examples and docs but the registry metadata lists none. Examples reference: TELEGRAM_BOT_TOKEN, TELEGRAM_WEBHOOK_SECRET, MODERATION_CORE_ENDPOINT, MODERATION_CORE_TOKEN, TELEGRAM_API_BASE, TELEGRAM_ADMIN_REVIEW_CHAT_ID, TELEGRAM_WARN_MESSAGE_TEMPLATE, TELEGRAM_MUTE_SECONDS, plus Redis/DB credentials in docs. Not declaring these in metadata is an incoherence — the skill will not function without these secrets, and they are central to its operation (bot token allows Telegram actions; moderation endpoint receives message content).
Persistence & Privilege
The skill does not request 'always: true' or any elevated platform privileges and does not modify other skills. It performs network calls and may persist moderation logs according to user configuration (DB/Redis/file), which is expected. Autonomous invocation is allowed (platform default) — combine this with the credential mismatch when deciding whether to enable it.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install telegram-group-moderation - 安装完成后,直接呼叫该 Skill 的名称或使用
/telegram-group-moderation触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.9.0
- Added version, emoji, homepage, and platform requirements to the SKILL.md manifest.
- Declared dependency on the post-content-moderation skill.
- Updated metadata to specify that Python 3 is required for OpenClaw compatibility.
- No moderation logic or API changes; documentation/packaging metadata only.
v0.1.3
Audit/logging update: add trace_id flow, PDO-based audit log store, audit log schema examples, action_result persistence, and production docs for log rollout and v2 HTTP contract.
v0.1.2
Production-facing update: implement Redis and PDO-based DB offense stores, add DB schema example, strengthen production HTTP contract/config guidance, and expand rollout docs.
v0.1.1
Production-oriented update: add rollout guidance, env template, moderation-core HTTP contract example, clearer deployment boundaries, and stronger Telegram action/demo documentation.
v0.1.0
Initial release: Telegram moderation integration layer with webhook normalization, delete/warn/mute/ban/review action mapping, offense-count ladder demo, Chinese docs, and PHP/Python/Go/Java examples.
元数据
常见问题
Telegram Group Moderation 是什么?
Moderate Telegram groups with a bot by receiving message/webhook events, extracting text/caption/media context, applying anti-advertising and anti-contact po... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 239 次。
如何安装 Telegram Group Moderation?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install telegram-group-moderation」即可一键安装,无需额外配置。
Telegram Group Moderation 是免费的吗?
是的,Telegram Group Moderation 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Telegram Group Moderation 支持哪些平台?
Telegram Group Moderation 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Telegram Group Moderation?
由 Xavier Mary(@xaviermary56)开发并维护,当前版本 v0.9.0。
推荐 Skills