telegram-pairing-approver

What This Skill Does

The telegram-pairing-approver skill is a specialized automation tool designed for OpenClaw users who need to manage multiple Telegram sessions efficiently. Instead of manually monitoring and typing codes whenever a new session requires authorization, this skill deploys a persistent background service (as a systemd daemon). The service acts as a Telegram bot that monitors incoming messages for pairing codes, automatically extracts them regardless of the format (raw, 'code:' prefix, or 'Pairing code:' prefix), and executes the 'openclaw pairing approve telegram <code>' command instantly. By running as a system-level service, it ensures 24/7 uptime and automatic recovery, making it an essential utility for automated infrastructure where Telegram-based authentication is frequent.

Installation

Installation is streamlined through the OpenClaw skill registry. Execute the following command in your terminal:

clawhub install openclaw/skills/skills/crazypeace/telegram-pairing-approver

Once installed, you must perform the deployment initialization to link your specific Telegram Bot Token. Navigate to the skill directory and run:

node scripts/deploy.js <YOUR_BOT_TOKEN>

This command performs the heavy lifting: it writes the operational script, generates the systemd configuration file, reloads the system daemon, and enables the service to start automatically upon system boot. You can verify the installation status by running 'systemctl status telegram-pairing-bot.service'.

Use Cases

• Automating bot farm authentication where hundreds of Telegram accounts must be authorized periodically.
• Managing high-volume OpenClaw agent clusters that rely on Telegram as their primary control interface.
• Reducing human latency in approval workflows, ensuring that sessions do not time out while waiting for administrative input.
• Simplifying DevOps workflows where developers require unattended session management for server-side agents.

Example Prompts

1. "OpenClaw, setup the telegram-pairing-approver using my bot token 9632389037:ADG3jTndsXpgdOrdJkfaV80nnsjhQyWEhbT so I never have to manually approve a session again."
2. "I need to check if my telegram-pairing-bot is still running correctly, can you pull the systemd status for me?"
3. "The pairing service isn't picking up codes, please restart the telegram-pairing-bot.service and show me the recent logs."

Tips & Limitations

• Security: Keep your Bot Token private. Never share the token generated by BotFather in public repositories or logs. If your token is compromised, revoke it immediately via Telegram.
• Permissions: Because the skill installs a systemd service, you must have sudo or root privileges on the host machine to complete the deployment.
• Scope: This tool is specifically designed to handle 'pairing' codes. It will not handle other Telegram interactions or general chatbot tasks. If you require advanced conversational capabilities, you may need to extend the generated script or chain it with other OpenClaw skills. Monitor the logs using 'journalctl -u telegram-pairing-bot.service -f' if you encounter unexpected errors during approval flows.