An automated workflow to download, filter, and organize PDF documents from Telegram channels into structured local folders.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install telegram-pdf-scraper
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install telegram-pdf-scraper using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Telegram PDF Segregator?
The Telegram PDF Segregator is a specialized automation tool designed to streamline the retrieval of educational and research materials from Telegram. By integrating with Openclaw Skills, this agent automates the interaction with Telegram Web to identify, download, and categorize PDF files based on message headers. It solves the problem of cluttered download folders by creating a logical directory structure that mirrors the organization of the source channel, making it an essential tool for students and digital archivists.
Telegram PDF Segregator Use Cases
- Automatically archiving study materials from academic Telegram channels.
- Organizing research papers and technical documentation into categorized local folders.
- Bulk downloading PDF resources from community groups without manual intervention.
- Maintaining a clean local repository of documents synchronized with Telegram chat headers.
How Telegram PDF Segregator Works
- The user authenticates their session by logging into Telegram Web (A or K version) in a Chrome browser.
- The skill receives the target channel name and an optional local directory path.
- It scans the channel's message history to detect native Telegram Document objects.
- Using message headers as metadata, the skill dynamically creates local sub-directories.
- Only .pdf files are downloaded and placed into the corresponding folders while safety filters block malicious external links.
Telegram PDF Segregator Setup
To deploy this skill within your environment, ensure you are logged into Telegram Web and execute the following command through your terminal:
# Run the segregator by specifying the channel and destination
openclaw run telegram-pdf-segregator --channel_name "Engineering_Books" --download_dir "~/Documents/Library"
Telegram PDF Segregator Data Schema & Taxonomy
The skill organizes downloaded content using a hierarchical structure derived from the Telegram chat context:
| Component | Logic | Description |
|---|---|---|
| Root Directory | User Input | The base path defined in the download_dir parameter. |
| Sub-folders | Message Headers | Folders named according to the text headers found immediately above documents in the chat. |
| Files | Document Filter | Native .pdf files identified as Telegram Document objects. |
| Safety Filter | Domain Blacklist | Hard-coded list to ignore links from unsafe domains like bit.ly or publicearn.in. |
Telegram PDF Segregator Advanced Features
- Intelligent anti-malware protection that blocks downloads from suspicious external link shorteners.
- Dual-version support for both Telegram Web A and Web K interfaces.
- Native Document object interaction to ensure high-speed, secure downloads without triggering browser pop-up blocks.
- Automated folder mapping that translates chat message patterns into structured file systems using Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Skill Reviewer
A professional quality assurance tool designed to audit AgentSkill files for logical integrity, token efficiency, and structural clarity.
Counter-Evidence Hunter
Counter-Evidence Hunter is a specialized AI agent skill designed to act as a digital bloodhound, actively seeking out conflicting evidence and alternative explanations to stress-test claims.
SellerSprite Product Research
A powerful command-line interface for SellerSprite that enables automated Amazon market research, keyword analysis, and competitor tracking.
Obsidian Vault Context
A skill that transforms an Obsidian vault into a shared, persistent workspace where AI agents and users collaborate via markdown files rather than just chat.
CN Resume Optimizer
A professional AI career assistant designed to optimize resumes, draft job application materials, and provide end-to-end interview preparation support.
viz-table
A powerful data visualization tool that converts CSV or JSON files into interactive, professional ECharts HTML reports with real-time analysis features.
Featured*
