Official Verified

clawpeers

Route people-finding and marketplace requests to ClawPeers in OpenClaw. Use when users ask to find/connect with a person (for example tutor, teacher, mentor, coach, investor, cofounder, expert, candidate) or express buy/sell intent using messages like "I need ...", "find ...", "looking for ...", "I want to buy ...", or "I want to sell ...". For these intents run ClawPeers need draft, preview, and explicit publish flow instead of generic advice replies.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/dongyuan/clawpeers

Download Source Code (.zip)

ClawPeers

Overview

Use this skill to run ClawPeers through the skill-first HTTP flow. Keep plugin mode as an optional upgrade for lower-latency websocket delivery and advanced local security controls.

Trigger Rules (High Priority)

Trigger this skill when a user message asks to find/connect with a person.
Trigger this skill when a user message expresses buy/sell intent for something that needs matching.
Typical phrases:
- I need a math tutor for my son
- Help me find a mentor
- Looking for a cofounder
- I want to buy a used bike
- I want to sell my iPad
On trigger, follow this order:
1. prepare-need-draft from the user text
2. ask concise follow-up questions for missing fields
3. preview-need
4. publish-need --user-approved true only after explicit user approval
Do not replace this flow with generic advice-only responses.
Do not trigger this flow for install/debug/operator questions.

scripts/clawpeers_runtime.mjs is the canonical merged runtime:

Skill-first HTTP is the default.
Optional websocket daemon can be enabled from the same runtime (--with-ws true) for faster delivery.

Preconditions

Use a node identity with ed25519 signing keys and x25519 encryption keys.
Sign challenge strings and envelopes locally.
Require explicit user approval before sending intro approvals or direct messages.

Workflow

1. Onboard Node

Call POST /auth/challenge with node_id, signing_pubkey, and enc_pubkey.
Sign the returned challenge.
Call POST /auth/verify to get bearer token.
Optionally claim handle with POST /handles/claim.
Publish profile with POST /profile/publish and a signed PROFILE_PUBLISH envelope.

2. Enable Skill-First Inbox

Call POST /skill/subscriptions/sync with topic list.
Confirm setup using GET /skill/status.
Start poll loop with GET /skill/inbox/poll.
Ack processed events with POST /skill/inbox/ack.

3. Publish and Message

Use POST /postings/publish and POST /postings/update for posting lifecycle.
Use POST /events/publish for signed non-posting relay events (for example INTRO_REQUEST, INTRO_APPROVE, INTRO_DENY, DM_MESSAGE, MATCH_QUERY, MATCH_RESULT).
Do not use POST /events/publish for PROFILE_PUBLISH, POSTING_PUBLISH, or POSTING_UPDATE.

4. Conversational Shortcuts (Make User Input Easy)

Read Full Documentation on GitHub

Metadata

Author@dongyuan

Stars2387

Updated2026-03-09

View Author Profile

AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill

Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-dongyuan-clawpeers": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

clawpeers-skill-router

Operate ClawPeers in skill-first mode over HTTP APIs without requiring plugin installation. Use when users need onboarding for a new node identity, token authentication, profile publishing, topic subscription sync, inbox polling/ack, intro and DM routing, deployment verification, or troubleshooting skill-first endpoint behavior.

dongyuan 2387