← Back to Skills Marketplace
rhlsthrm

Telegram History

by Rahul Sethuram · GitHub ↗ · v1.1.0
cross-platform ✓ Security Clean
1902
Downloads
1
Stars
15
Active Installs
3
Versions
Install in OpenClaw
/install telegram-history
Description
Fetch Telegram chat message history via MTProto user API (Telethon). Use when needing to read old messages from any Telegram chat, group, or forum topic that...
Usage Guidance
This skill appears to do exactly what it says: it uses Telethon and your Telegram app credentials to log in as a user and fetch message history. Before installing/running: (1) Create the Telegram app credentials yourself at my.telegram.org (do not reuse someone else's keys). (2) Understand that api_id/api_hash + the created session file grant access to your Telegram account — treat them like sensitive secrets. (3) Run pip install telethon in an isolated environment (venv) and inspect the included scripts (they are short and readable). (4) If you want to prevent autonomous agent calls, disable model invocation for the skill or ensure the agent cannot call it without explicit approval. (5) To revoke access later, delete the session/ directory and, if necessary, revoke the app from your Telegram account.
Capability Analysis
Type: OpenClaw Skill Name: telegram-history Version: 1.1.0 The OpenClaw skill 'telegram-history' is designed to fetch Telegram chat history using the Telethon library. The code and documentation align with this stated purpose, requiring legitimate Telegram API credentials and user login. There is no evidence of data exfiltration to unauthorized endpoints, malicious execution (e.g., `curl|bash`), persistence mechanisms, or prompt injection attempts against the OpenClaw agent. Sensitive credentials and session files are stored locally within the skill directory, which is standard practice for such functionality. The provided shell commands in `SKILL.md` are standard usage examples and do not contain malicious payloads.
Capability Assessment
Purpose & Capability
Name/description, SKILL.md, and the two Python scripts all consistently implement a Telethon-based MTProto client for fetching chat history. Requiring api_id/api_hash and a user login (phone + optional 2FA) is expected for this purpose.
Instruction Scope
Runtime instructions only reference creating api_credentials.json and the local session directory under the skill directory and running the included scripts. They do not request unrelated files, environment variables, or external endpoints beyond Telegram and the my.telegram.org app creation site.
Install Mechanism
There is no automated install spec; the SKILL.md asks the user to pip install telethon. No remote downloads or archive extraction are performed by the skill itself.
Credentials
No environment variables or unrelated credentials are requested. The skill asks for api_id/api_hash (Telegram app credentials) and a phone/2FA code — these are necessary for user-mode MTProto access and are proportionate to the stated function.
Persistence & Privilege
The skill stores a Telethon session under session/user inside the skill directory (expected). always:false. Note that if the agent/platform is permitted to invoke the skill autonomously, the skill can read chat history whenever it has access to those local session files and credentials; this is normal but worth noting.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install telegram-history
  3. After installation, invoke the skill by name or use /telegram-history
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Fix: use relative paths instead of hardcoded home dir. Fix: SKILL.md now matches actual CLI arguments. Phone number is a required argument, not hardcoded.
v1.0.1
Fix: removed hardcoded phone number, phone is now a CLI argument
v1.0.0
Initial release: fetch Telegram chat/topic history via MTProto
Metadata
Slug telegram-history
Version 1.1.0
License
All-time Installs 15
Active Installs 15
Total Versions 3
Frequently Asked Questions

What is Telegram History?

Fetch Telegram chat message history via MTProto user API (Telethon). Use when needing to read old messages from any Telegram chat, group, or forum topic that... It is an AI Agent Skill for Claude Code / OpenClaw, with 1902 downloads so far.

How do I install Telegram History?

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

Is Telegram History free?

Yes, Telegram History is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Telegram History support?

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

Who created Telegram History?

It is built and maintained by Rahul Sethuram (@rhlsthrm); the current version is v1.1.0.

💬 Comments