A comprehensive utility for managing personal Telegram account authentication workflows, session persistence, and multi-namespace logins for AI agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install telegram-login-helper
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-login-helper 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 Login Helper?
Telegram Login Helper is a specialized skill designed to solve the complexities of personal Telegram account authentication, moving beyond simple bot tokens. It provides a robust framework for managing tdl and TDLib sessions, ensuring that AI agents can maintain persistent access to personal accounts without redundant login prompts. By prioritizing session reuse and local state migration, it minimizes the need for manual human intervention.
This skill is particularly valuable for developers using Openclaw Skills who need to automate interactions with MTProto-based accounts. It handles everything from single QR code logins to batch processing multiple namespaces, providing a clear runbook for local login states and graceful fallbacks when human assistance or specific API credentials like TELEGRAM_API_ID are required.
Telegram Login Helper Use Cases
- Resolving stuck tdl or TDLib login processes during agent execution.
- Automating QR code logins for multiple account namespaces simultaneously.
- Migrating existing TDLib session states between different environments or agents.
- Establishing a reliable local login runbook for headless AI operations.
- Verifying account 'liveness' and chat access post-authentication.
How Telegram Login Helper Works
- Namespace Verification: The skill first attempts to reuse existing namespaces (e.g., 'steve') to check if the session is still active.
- QR Authentication: If no session exists, it initiates a QR code login for single or batch account setups.
- State Migration: It facilitates the copying of TDLib data folders from known working directories to bypass repetitive scanning.
- Credential Escalation: For advanced MTProto operations, it requests API ID and Hash credentials.
- Human Fallback: As a final resort, it provides an honest escalation path for manual human assistance when automated methods fail.
Telegram Login Helper Setup
To get started with this component of Openclaw Skills, ensure you have tdl installed and the skill directory mapped. Use the following commands for common tasks:
# Reuse an existing namespace and list chats
bash /home/stevewu/.openclaw/workspace/skills/telegram-login-helper/scripts/reuse_namespace.sh steve 5
# Initiate a new QR login for a specific namespace
tdl login -n tg1 -T qr
# Batch login 10 namespaces via script
bash /home/stevewu/.openclaw/workspace/skills/telegram-login-helper/scripts/login_10_namespaces.sh
Telegram Login Helper Data Schema & Taxonomy
The skill manages data primarily through the tdl configuration and TDLib state directories. Below is the metadata and file structure:
| Path | Description |
|---|---|
~/.tdl/data |
Default directory for TDLib state and session files. |
/scripts/ |
Contains bash utilities for namespace reuse and batch login. |
/references/runbook.md |
Detailed technical guide for login lifecycle management. |
metadata |
Includes versioning (1.0.0), MIT license, and relevant MTProto tags. |
Telegram Login Helper Advanced Features
- Multi-Namespace Management: Support for handling dozens of concurrent personal account sessions.
- Session State Injection: Directly inject working TDLib states into the data directory to avoid account locking.
- Agent Integration Hooks: Provides standardized paths and scripts that other Openclaw Skills (like telegram-personal-ops) can call to verify connectivity.
- Anti-Bot Logic: Specifically ignores Bot API tokens to focus on the high-privilege personal account (MTProto) layer.
SKILL.md
Loading
Related Openclaw Skills
Mini Coder Max
An autonomous coding agent that manages the full software development lifecycle from architectural planning to quality-assured delivery.
Loewe Brand Intelligence
A specialized research skill focused on the historical evolution, business logic, and creative transformation of the Loewe luxury brand under LVMH.
Minimax Crypto Trading Agent
A professional-grade crypto trading decision agent designed to prioritize capital preservation through multi-layer game theory analysis.
App Builder Skill
A comprehensive framework for building and scaling full-stack applications through structured project detection, tech stack selection, and iterative feature development.
ImageCraft
A unified image generation engine specializing in curated 3D styles across characters, scenes, products, and creative transformations.
Web AI Image Generation
Automate high-quality AI image generation via Gemini and ChatGPT web interfaces using browser automation to bypass API constraints.
Featured*
