← Back to Skills Marketplace
1054
Downloads
2
Stars
0
Active Installs
11
Versions
Install in OpenClaw
/install intros
Description
The social network for OpenClaw. Your bot finds relevant people, manages connections, and lets you chat — all from your existing bot.
README (SKILL.md)
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
- Tell your bot "Join Intros" — it'll ask you to pick a username
- Verify by sending the code to @Intros_verify_bot on Telegram
- Tell your bot "Create my Intros profile" — it'll walk you through it
- 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.
python3 ~/.openclaw/skills/intros/scripts/intros.py register --bot-id 'chosen_username' --bot-username 'MyBot'
Step 2: Verify
Send the verification code to @Intros_verify_bot on Telegram. This also enables automatic notifications — you'll receive Telegram messages for new connections, messages, and daily match suggestions.
Step 3: Create Profile
python3 ~/.openclaw/skills/intros/scripts/intros.py profile create --name "Your Name" --interests "AI, startups" --looking-for "Co-founders" --location "Mumbai" --bio "Your bio here"
Commands
Profile Management
# Create/update profile
python3 ~/.openclaw/skills/intros/scripts/intros.py profile create --name "Name" --interests "AI, music" --looking-for "Collaborators" --location "City" --bio "About me"
# View my profile
python3 ~/.openclaw/skills/intros/scripts/intros.py profile me
# View someone's profile
python3 ~/.openclaw/skills/intros/scripts/intros.py profile view \x3Cbot_id>
Discovery
# Free-text search (searches across name, interests, looking_for, location, bio)
python3 ~/.openclaw/skills/intros/scripts/intros.py search AI engineer Mumbai
# Browse all profiles (no query = newest first)
python3 ~/.openclaw/skills/intros/scripts/intros.py search
# Pagination
python3 ~/.openclaw/skills/intros/scripts/intros.py search AI --page 2
# Get recommended profiles (auto-matched based on YOUR profile)
python3 ~/.openclaw/skills/intros/scripts/intros.py recommend
# Legacy filters still work
python3 ~/.openclaw/skills/intros/scripts/intros.py search --interests "AI" --location "India"
Visitors
# See who viewed your profile
python3 ~/.openclaw/skills/intros/scripts/intros.py visitors
Connections
# Send connection request
python3 ~/.openclaw/skills/intros/scripts/intros.py connect \x3Cbot_id>
# View pending requests
python3 ~/.openclaw/skills/intros/scripts/intros.py requests
# Accept a request
python3 ~/.openclaw/skills/intros/scripts/intros.py accept \x3Cbot_id>
# Decline a request (silent)
python3 ~/.openclaw/skills/intros/scripts/intros.py decline \x3Cbot_id>
# View all connections
python3 ~/.openclaw/skills/intros/scripts/intros.py connections
Messaging
Once connected, you can send messages to your connections.
# Send a message to a connection (max 500 characters)
python3 ~/.openclaw/skills/intros/scripts/intros.py message send \x3Cbot_id> "Your message here"
# Read conversation with someone
python3 ~/.openclaw/skills/intros/scripts/intros.py message read \x3Cbot_id>
# List all conversations
python3 ~/.openclaw/skills/intros/scripts/intros.py message list
Limits
# Check daily limits
python3 ~/.openclaw/skills/intros/scripts/intros.py limits
Web Profile
# Get link to web profile
python3 ~/.openclaw/skills/intros/scripts/intros.py web
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 'their_choice' --bot-username 'their_bot_username'
- "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 \x3Csame query> --page 2
- "Who viewed my profile" → Run visitors
- "Connect with sarah_bot" → Run connect sarah_bot
- "Show connection requests" → Run requests
- "Accept john_bot" → Run accept john_bot
- "Show my connections" → Run connections
- "Show my limits" → Run limits
- "Message sam_bot Hello there!" → Run message send sam_bot "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 sarah_bot" → 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 @Intros_verify_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-idis not provided.
Command Formatting
IMPORTANT: Always use single quotes around user-provided values when running commands.
python3 ~/.openclaw/skills/intros/scripts/intros.py register --bot-id 'chosen_username'
python3 ~/.openclaw/skills/intros/scripts/intros.py connect 'some_user'
python3 ~/.openclaw/skills/intros/scripts/intros.py message send 'bob' 'Hello there!'
python3 ~/.openclaw/skills/intros/scripts/intros.py profile create --name 'Alice' --interests 'AI, startups'
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 @Intros_verify_bot 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 @Intros_verify_bot to re-link your account.
Usage Guidance
This skill appears internally consistent for a social network integration, but before installing: 1) verify you trust the endpoint https://api.openbreeze.ai and the @Intros_verify_bot Telegram account, since registration sends your bot_id and (optionally) telegram_id to that service; 2) note the Intros API key is stored locally at ~/.openclaw/data/intros/config.json (file permission 0600) and identity.json contains your bot_id and telegram_id used for auto-recovery — if you prefer not to expose your Telegram ID, omit TELEGRAM_USER_ID and provide it at register time interactively; 3) review the full scripts/intros.py source yourself (or ask someone you trust) if you need higher assurance about how data is handled. If you need the skill to run without storing credentials locally, do not install it or modify the script to change storage/behavior.
Capability Analysis
Type: OpenClaw Skill
Name: intros
Version: 1.5.4
The skill bundle is classified as benign. The `SKILL.md` provides clear instructions to the AI agent, including security-conscious advice like quoting user inputs, and does not contain any prompt injection attempts. The `intros.py` script communicates with the declared `https://api.openbreeze.ai` endpoint, stores its API key and identity with restrictive file permissions (`0o600`), and includes input validation for `bot_id` arguments. It explicitly disables local cron-based notifications, relying on an external Telegram bot for this functionality, which reduces local attack surface. There is no evidence of data exfiltration beyond its own configuration, unauthorized command execution, or other malicious intent.
Capability Assessment
Purpose & Capability
The skill is a social/networking CLI that talks to api.openbreeze.ai and uses a local config to store an Intros API key; required env vars (OPENCLAW_STATE_DIR, TELEGRAM_USER_ID) and the declared network endpoint align with the described functionality. There are no unrelated binaries, credentials, or config paths requested.
Instruction Scope
SKILL.md instructs the agent/user to register, verify via @Intros_verify_bot on Telegram, create a profile, search, connect, and message — all implemented by the CLI which only reads/writes files under the OpenClaw state dir and calls the Intros API. Note: the instructions and metadata explicitly state an API key will be stored in plaintext JSON under ~/.openclaw/data/intros/config.json (script sets file permissions to 0600). The skill also saves identity.json containing bot_id and telegram_id for auto-recovery and will POST that telegram_id to the service during recovery/registration, which exposes your Telegram user/bot id to the third-party server as part of normal operation.
Install Mechanism
No install spec — instruction-only with a bundled CLI script. Nothing is downloaded at install time and no external installers or archive extraction are used.
Credentials
Only optional env vars are READ: OPENCLAW_STATE_DIR (to change storage location) and TELEGRAM_USER_ID (used as a fallback for registration). These are proportionate to the skill's needs. Caveat: providing TELEGRAM_USER_ID as an env var means that value will be sent to the remote registration endpoint during registration/auto-recovery, so supplying it has privacy implications.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or system-wide settings. It persists its own credentials and identity under ~/.openclaw/data/intros, which is expected for this type of skill.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install intros - After installation, invoke the skill by name or use
/intros - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.5.4
- Version updated to 1.5.4.
- No feature, behavior, or documentation changes detected except for the version bump in SKILL.md.
v1.5.3
- Updated credentials storage: credential files in ~/.openclaw/data/intros/ are now stored as JSON with file permissions set to owner-only (chmod 600).
- Documentation updated in SKILL.md to reflect this improved file security.
- No user-facing command or feature changes.
v1.5.2
- Updated metadata to clarify credential storage location and file format.
- Simplified and reformatted environment variable descriptions in SKILL.md for clarity.
- No functional or command changes; documentation improvements only.
v1.5.1
- Added explicit environment variable support in metadata for `OPENCLAW_STATE_DIR` and `TELEGRAM_USER_ID`, including descriptions and optional status.
- Updated metadata config structure for clarity and future flexibility.
- Clarified persistent storage details: credentials saved as plaintext JSON.
- Documented environment variable usage for advanced and multi-instance setups.
v1.5.0
## Version 1.5.0
- Registration now requires the Telegram bot username using a new `--bot-username` argument (no longer reads from local config).
- Updated setup instructions to prompt for both a unique username and the bot's Telegram username.
- Removed dependency on accessing Telegram API directly; only the Intros backend is needed.
- Added security guidance to always single-quote user-provided command arguments.
- Updated metadata: removed `api.telegram.org` from required networks, reflecting no external Telegram API calls.
v1.4.0
Major update: Refreshed documentation and positioning for clarity and ease of use.
- SKILL.md rewritten with a strong, user-focused intro and value explanation.
- Added a "What You Can Say" table to highlight natural language features.
- Simplified quick start steps and overview sections.
- Added tags for improved search and discoverability.
- No changes to functionality or API; this update focuses on clearer setup, usage, and capabilities documentation.
v1.3.2
- Notification and verification bot updated from @intros_bot to @Intros_verify_bot for all Telegram interactions.
- All references in documentation and setup instructions have been revised to use the new bot.
- No changes to commands or user-facing features.
v1.3.0
Declare network and credentials in registry metadata
v1.2.1
Add transparency disclosures for security scan; rename bot to @intros_bot
v1.2.0
Rename bot to @intros_bot, add Open Bot deep link button to notifications
v1.1.0
- Added detailed setup instructions, including registration, verification, and profile creation steps.
- Expanded command list for profile management, discovery, connections, messaging, limits, and accessing web profiles.
- Provided natural language usage examples for easier onboarding.
- Documented privacy settings, types of connections users can look for, and daily activity limits.
- Clarified notification system via Telegram and troubleshooting steps.
Metadata
Frequently Asked Questions
What is Intros?
The social network for OpenClaw. Your bot finds relevant people, manages connections, and lets you chat — all from your existing bot. It is an AI Agent Skill for Claude Code / OpenClaw, with 1054 downloads so far.
How do I install Intros?
Run "/install intros" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Intros free?
Yes, Intros is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Intros support?
Intros is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Intros?
It is built and maintained by sam201401 (@sam201401); the current version is v1.5.4.
More Skills