Intros

A social network that lives inside your OpenClaw bot. Find co-founders, collaborators, mentors, and friends — without leaving your chat.

What You Get

• - Discovery — Search by interests, skills, or location. Or let recommendations find people for you.
• Privacy-first connections — Telegram handles stay hidden until both sides accept.
• Messaging — Chat with your connections directly through your bot.
• Telegram notifications — Get notified instantly when someone messages you, sends a request, or accepts your connection.
• Daily limits — 10 profile views and 3 connection requests per day keep things intentional.

Quick Start

1. 1. Tell your bot "Join Intros" — it'll ask you to pick a username
2. Verify by sending the code to @Introsverifybot on Telegram
3. Tell your bot "Create my Intros profile" — it'll walk you through it
4. Say "Who should I connect with?" to start discovering people

That's it. Your bot handles the rest.

What You Can Say

What you want	What to say
Join the network	"Join Intros"
Set up your profile

"Create my Intros profile" | | Find people | "Find co-founders in Mumbai" or "Search AI engineers" | | Get recommendations | "Who should I connect with?" or "Suggest people" | | Browse everyone | "Browse profiles" | | Connect with someone | "Connect with sarah_bot" | | Handle requests | "Show connection requests" / "Accept john_bot" | | Send a message | "Message sam_bot Hey, want to collaborate?" | | Read messages | "Chat with sarah_bot" or "Show my conversations" | | Check limits | "Show my limits" | | See visitors | "Who viewed my profile?" |

---

Setup (detailed)

Step 1: Register

IMPORTANT: Before running register, ask the user to choose a unique username (lowercase, no spaces, like a Twitter handle). Also ask for their Telegram bot username (e.g. @MyBot) — this enables "Open Bot" deep link buttons on notifications.

CODEBLOCK0

Step 2: Verify

Send the verification code to @Introsverifybot on Telegram. This also enables automatic notifications — you'll receive Telegram messages for new connections, messages, and daily match suggestions.

Step 3: Create Profile

CODEBLOCK1

Commands

Profile Management

CODEBLOCK2

Discovery

CODEBLOCK3

Visitors

CODEBLOCK4

Connections

CODEBLOCK5

Messaging

Once connected, you can send messages to your connections.

CODEBLOCK6

Limits

CODEBLOCK7

Web Profile

CODEBLOCK8

Natural Language Examples

When user says:

• - "Join Intros" → First ask "Choose a unique username for Intros (lowercase, no spaces):" and "What's your Telegram bot username? (e.g. @MyBot)", then run register --bot-id 'theirchoice' --bot-username 'theirbotusername'
• "Create my Intros profile" → Run profile create with guided questions
• "Find co-founders" → Run search co-founders
• "Find people interested in AI" → Run search AI
• "Find AI people in Mumbai" → Run search AI Mumbai
• "Who should I connect with?" → Run recommend
• "Suggest people for me" → Run recommend
• "Browse profiles" → Run search (no query)
• "Show me more results" → Run search --page 2
• "Who viewed my profile" → Run visitors
• "Connect with sarahbot" → Run connect sarahbot
• "Show connection requests" → Run requests
• "Accept johnbot" → Run accept johnbot
• "Show my connections" → Run connections
• "Show my limits" → Run limits
• "Message sambot Hello there!" → Run message send sambot "Hello there!"
• "Send message to alice: Want to collaborate?" → Run message send alice "Want to collaborate?"
• "Read messages from john" → Run message read john
• "Show my conversations" → Run message list
• "Chat with sarahbot" → Run message read sarah_bot (show conversation history)

How It Works

• - API Server: All data is stored on the Intros backend at https://api.openbreeze.ai (source: github.com/sam201401/intros)
• Registration: During register, you provide your bot's Telegram username via --bot-username. This is used solely to add an "Open Bot" deep link button on notification messages. No local config files are read.
• Persistent storage: The skill saves your API key and identity to ~/.openclaw/data/intros/ (JSON, chmod 600 owner-only) so credentials survive skill reinstalls. Delete this directory to revoke stored credentials.
• Auto-recovery: If config is lost (e.g. after reinstall), the skill re-registers using your saved identity file. This is idempotent and returns existing credentials.
• Notifications: Sent via @Introsverify_bot on Telegram (server-side, no cron needed).
• Environment variables: OPENCLAW_STATE_DIR (optional) overrides the OpenClaw state directory for multi-instance setups. TELEGRAM_USER_ID (optional) is read as a fallback during registration if --telegram-id is not provided.

Command Formatting

IMPORTANT: Always use single quotes around user-provided values when running commands.

CODEBLOCK9

All bot_id arguments are validated (alphanumeric + underscores only, max 64 chars).

Looking For Options

Users can specify what they're looking for:

• - Co-founders
• Collaborators
• Friends
• Mentors
• Hiring
• Open to anything

Privacy

• - Telegram handle is private by default
• Only shared after both users accept connection
• User can make Telegram public in profile settings

Notifications

Notifications are delivered automatically via @Introsverifybot on Telegram. After verifying, you'll receive:

• - New messages — when someone sends you a message
• Connection requests — when someone wants to connect
• Accepted connections — when your request is accepted
• Daily matches — once per day, a nudge to check your recommended profiles

No cron jobs or gateway setup needed. Notifications are checked every 60 seconds server-side.

If you're not receiving notifications, send /start to @Introsverifybot to re-link your account.