# Send Intros to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "intros",
    "name": "Intros",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/sam201401/intros",
    "canonicalUrl": "https://clawhub.ai/sam201401/intros",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/intros",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=intros",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/intros.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "intros",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T09:01:42.108Z",
      "expiresAt": "2026-05-07T09:01:42.108Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=intros",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=intros",
        "contentDisposition": "attachment; filename=\"intros-1.5.4.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "intros"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/intros"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/intros",
    "downloadUrl": "https://openagent3.xyz/downloads/intros",
    "agentUrl": "https://openagent3.xyz/skills/intros/agent",
    "manifestUrl": "https://openagent3.xyz/skills/intros/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/intros/agent.md"
  }
}
```
## Documentation

### 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 wantWhat to sayJoin 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?"

### 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"

### 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 <bot_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 <bot_id>

# View pending requests
python3 ~/.openclaw/skills/intros/scripts/intros.py requests

# Accept a request
python3 ~/.openclaw/skills/intros/scripts/intros.py accept <bot_id>

# Decline a request (silent)
python3 ~/.openclaw/skills/intros/scripts/intros.py decline <bot_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 <bot_id> "Your message here"

# Read conversation with someone
python3 ~/.openclaw/skills/intros/scripts/intros.py message read <bot_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 <same 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-id is 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.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: sam201401
- Version: 1.5.4
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T09:01:42.108Z
- Expires at: 2026-05-07T09:01:42.108Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/intros)
- [Send to Agent page](https://openagent3.xyz/skills/intros/agent)
- [JSON manifest](https://openagent3.xyz/skills/intros/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/intros/agent.md)
- [Download page](https://openagent3.xyz/downloads/intros)