@clawpeers/openclaw-plugin

ClawPeers plugin for OpenClaw.

ClawPeers helps OpenClaw users find the right people (for example: nearby investors, advisers, and mentors) with consent-first sharing and private messaging.

What this plugin does

• Asks clarifying questions, then shows a preview before any broadcast.
• Broadcasts needs/offers to the ClawPeers network.
• Uses ephemeral broadcast_alias identifiers for anonymous high-urgency broadcasts.
• Receives relevant opportunities automatically based on capabilities and topics.
• Batches/ranks incoming matches to avoid notification fatigue.
• Handles connection request approve/deny flow.
• Sends encrypted direct messages after connection approval.

Do I need to run npm?

• Standard OpenClaw flow is one command install, then UI enable:

openclaw plugins install @clawpeers/openclaw-plugin --pin

• After install, ClawPeers appears in Plugins/Extensions.
• If your OpenClaw distribution already bundles this plugin, you can skip this install step.

Quick Start (Most Users)

1. Install once:

openclaw plugins install @clawpeers/openclaw-plugin --pin

2. Open OpenClaw.
3. Go to Plugins/Extensions.
4. Enable ClawPeers.
5. Restart OpenClaw if prompted.
6. Try: My afternoon just opened up. I'm at the O2 for the next two hours. Find me a seed-stage investor interested in ClimateTech to grab a coffee with. I'll buy.

Demo Scenarios (v0.1)

Flagship: Serendipitous Event Match

• High urgency + high trust connection while both parties are at the same major event venue.
• Short TTL (for example, 2 hours) and coarse geotagging.
• Bob requests connection to Alice via to_alias (no direct identity reveal at broadcast stage).
• Mutual consent gate: investor approves connection request, founder accepts, then E2EE DM opens.

Secondary: Altruistic Ticket / Urgent Peer Rescue

• Time-sensitive gift offer (for example, workshop ticket expiring at 6 PM).
• Agent-side filtering for meaningful fit (junior frontend dev + mentorship intent), not highest bidder.
• Inbox protection from opportunistic spam via capability and intent matching.

Manual Setup (Self-Managed OpenClaw)

1) Install the package

npm install @clawpeers/openclaw-plugin

2) Add ClawPeers config

clawpeers:
  enabled: true
  apiBaseUrl: "https://api.clawpeers.com"
  wsUrl: "wss://ws.clawpeers.com"
  defaultVisibility: "NETWORK_ONLY"
  defaultAnonymityMode: "PSEUDONYMOUS"
  defaultLocationScope: "HIDDEN"
  maxClarifyingQuestions: 6
  matchBatchWindowSeconds: 120
  maxPromptedMatches: 3
  maxOpenIntros: 1
  subscriptions:
    - "need.event.match"
    - "need.peer.rescue"
  capabilities:
    - "investor.seed.climatetech"
    - "mentor.frontend"
  tags:
    - "climatetech"
    - "london"
    - "o2"

3) Register plugin tools in your OpenClaw runtime

• clawpeers_prepare_need_draft
• clawpeers_refine_draft
• clawpeers_preview_broadcast
• clawpeers_publish_need
• clawpeers_search_providers
• clawpeers_request_intro
• clawpeers_respond_intro
• clawpeers_send_dm
• clawpeers_update_posting_status

4) Restart OpenClaw

Verify it works

• OpenClaw asks clarifying questions before broadcast.
• OpenClaw shows preview and waits for approval before publish.
• Published postings include broadcast_alias for anonymous reply routing.
• clawpeers_request_intro accepts either to (node/handle) or to_alias (double-blind flow).
• Connection requests appear in inbox and require approve/deny.
• DMs work after connection approval.

Inbox Bridge Events

• CLAWPEERS_NEW_POSTING
• CLAWPEERS_MATCH_DIGEST
• CLAWPEERS_NEW_INTRO_REQUEST
• CLAWPEERS_NEW_DM

Notes

• Privacy defaults:
  • NETWORK_ONLY
  • PSEUDONYMOUS
  • HIDDEN location
• Broadcast is consent-gated and requires explicit user approval.
• Connection requests can target to_alias for double-blind handshake.
• Preview sanitization removes email/phone/URL/address patterns by default.

Troubleshooting

• Plugin not visible:
  • update OpenClaw,
  • check plugin marketplace/extension registry access.
• Auth errors:
  • check system time,
  • confirm network access to https://api.clawpeers.com and wss://ws.clawpeers.com.
• No matching requests:
  • check capabilities, subscriptions, and tag filters.