A technical modification for Openclaw Skills that ensures Telegram users can retrieve their pairing code multiple times before approval.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install telegram-pairing-customization
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-pairing-customization 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 Pairing Customization?
This skill provides a step-by-step guide to modifying the internal pairing logic of the Openclaw gateway. By default, the system only sends a pairing code the first time a user interacts with the bot. This customization allows the system to resend the code whenever an unapproved user sends a /start message, significantly improving the onboarding experience for Openclaw Skills users.
This is particularly useful in environments where users might accidentally clear their chat history or miss the initial automated response. By adjusting the logical check from a creation event to a code existence check, developers can ensure persistent access to setup instructions without compromising the security of the approval workflow.
Telegram Pairing Customization Use Cases
- Users miss or delete the initial pairing code response from the Telegram bot.
- Improving the reliability of the onboarding workflow for new Openclaw Skills implementations.
- Ensuring that unapproved users have a consistent way to retrieve their pairing instructions without manual admin intervention.
How Telegram Pairing Customization Works
- The user sends a
/startcommand to the Telegram bot connected to Openclaw. - The backend calls
upsertTelegramPairingRequest, which returns the current pairing code and a boolean indicating if it was just created. - The modified logic checks for the existence of the code itself rather than just the creation event.
- If a valid, unapproved code exists, the bot sends the pairing instructions and the specific CLI command needed for approval to the user.
Telegram Pairing Customization Setup
To apply this customization to your Openclaw Skills setup, follow these steps:
- Locate the Openclaw installation directory, typically found at
/usr/lib/node_modules/openclaw/. - Search for the string
Ask the bot owner to approve with:to find the relevant logic file. - Locate the code block containing
if (created)and change the condition toif (code). - Restart the gateway service to apply changes:
openclaw gateway restart
Telegram Pairing Customization Data Schema & Taxonomy
The pairing logic within Openclaw Skills utilizes the following data structure during the registration handshake:
| Attribute | Description |
|---|---|
| code | The persistent pairing code generated for the specific Telegram User ID. |
| created | A boolean flag indicating if the pairing request was newly generated in the current session. |
| chatId | The unique identifier for the Telegram conversation. |
| username | The Telegram handle of the user requesting access. |
By switching the logic to check for the code attribute, the system serves existing pending codes regardless of the created status.
Telegram Pairing Customization Advanced Features
- Persistent pairing code retrieval for unapproved sessions.
- Automated formatting of CLI approval commands for bot owners.
- Multi-session support allowing users to request instructions from different devices before approval.
- Seamless integration with existing Openclaw Skills gateway logging and error handling.
SKILL.md
Loading
Related Openclaw Skills
Telegram Pairing Approver
A persistent system service that automatically detects and approves Telegram pairing codes for seamless session management.
OpenClaw Self-Clone Everything
A specialized skill for cloning and deploying an OpenClaw instance to a fresh remote VPS using SSH and automated scripts.
AWS Price CSV Generator
A powerful tool for generating itemized AWS pricing CSVs from service lists using real-time API or cached bulk data.
DJI Video Backup
An automated utility for transferring and indexing DJI camera footage from SD cards to networked storage solutions.
Telegram Pairing Message Customization
A technical utility to inject custom text and instructions into the automated pairing response for new Telegram bot users.
Persistent Telegram Pairing Codes
A technical modification for OpenClaw that ensures unapproved Telegram users receive their pairing code every time they send a start message.
METADATA
Featured*
