organize-tg

What This Skill Does

Organize TG by Consort Technologies is a powerful utility designed specifically for crypto and web3 founders, community managers, and power users who handle hundreds of Telegram conversations. It functions as a bridge between your Telegram messages and your business tracking ecosystem. The skill automatically scans your active, non-archived Telegram direct messages, identifies potential business contacts through pattern matching of professional affiliations, and syncs these contacts directly into a structured Google Sheet. By automating the data entry process, it ensures that your CRM or outreach tracking remains up-to-date without manual input, allowing you to focus on building relationships rather than managing spreadsheets.

Installation

To install this skill, use the Clawhub CLI within your terminal: clawhub install openclaw/skills/skills/consort-tech/organize-tg

CRITICAL: First-time Setup Because Telegram imposes strict security requirements regarding authentication, you must perform the initial configuration inside your own terminal, not via the OpenClaw chat interface. If you attempt to process verification codes through the chat, they will be rejected. Navigate to the skill directory and execute the setup script:

1. Open your terminal.
2. Run: cd ~/clawd/skills/tg-contact-sync
3. Run: ./tg-sync setup
4. Follow the terminal prompts, entering your Telegram credentials and the verification code directly into the terminal window. Once complete, you may use chat commands for all future operations.

Use Cases

• Investor Relations: Automatically pull contact details from Telegram DMs into a Google Sheet to track investor sentiment and follow-ups.
• Sales & Lead Gen: Identify and log new business partners or potential clients who have messaged you, ensuring no prospect is forgotten in the noise of a busy inbox.
• Networking Cleanup: Maintain a clean, sorted database of industry contacts, categorizing them by company or project affiliation identified during the scan.

Example Prompts

• "Organize my TG contacts"
• "Sync TG contacts from the past week"
• "Show pending TG contacts"

Tips & Limitations

• Browser Integration: Ensure your default web browser is logged into the same Google account that is connected to your gog CLI, otherwise, the sync will fail due to permission issues.
• Authentication Security: Never provide your Telegram 2FA or SMS verification code to the AI chat agent; always input these into the secure terminal prompt during the initial setup phase.
• Archiving: The tool only scans non-archived chats. To include specific contacts in your sync, ensure their conversations are active in your main Telegram list.
• Privacy: As this skill interacts with your private messages to extract business metadata, ensure you are comfortable with the scope of data access configured during the initial OAuth process.