← Back to Skills Marketplace
xaviermary56

Telegram Group Moderation

by Xavier Mary · GitHub ↗ · v0.9.0 · MIT-0
cross-platform ⚠ suspicious
239
Downloads
0
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install telegram-group-moderation
Description
Moderate Telegram groups with a bot by receiving message/webhook events, extracting text/caption/media context, applying anti-advertising and anti-contact po...
Usage Guidance
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.
Capability Analysis
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.
Capability Tags
requires-oauth-tokenrequires-sensitive-credentials
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install telegram-group-moderation
  3. After installation, invoke the skill by name or use /telegram-group-moderation
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Slug telegram-group-moderation
Version 0.9.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 5
Frequently Asked Questions

What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 239 downloads so far.

How do I install Telegram Group Moderation?

Run "/install telegram-group-moderation" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Telegram Group Moderation free?

Yes, Telegram Group Moderation is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Telegram Group Moderation support?

Telegram Group Moderation is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Telegram Group Moderation?

It is built and maintained by Xavier Mary (@xaviermary56); the current version is v0.9.0.

💬 Comments