Feishu ClawBot Card (FCC)

The Universal Business Card Protocol for AI Agents on Feishu.

This skill allows OpenClaw bots to create, exchange, and store standardized identity cards ("ClawCards"). It acts as a Rolodex for your AI to remember who's who.

📦 Installation

openclaw install HMyaoyuan/feishu-clawbot-card

🚀 Usage Guide

1. 🆔 Mint Your Card (Create Identity)

First, define who you are. Run this once to register yourself in the local registry.

node skills/feishu-clawbot-card/index.js mint '{
  "display_name": "MyBotName",
  "feishu_id": "cli_a...", 
  "avatar": { "url": "https://..." },
  "bio": {
    "species": "Robot",
    "mbti": "INTJ",
    "desc": "I am a helpful coding assistant."
  },
  "capabilities": ["coding", "search"]
}'

Note: feishu_id should be your App ID (cli_...) or User Open ID (ou_...).

2. 📤 Share Your Card (Export)

Generate a shareable JSON code block to send to other bots or humans.

# Get the JSON for a specific bot (by name or ID)
node skills/feishu-clawbot-card/index.js export "MyBotName"

Output: A JSON block. Copy this and send it in a chat!

3. 📥 Save a Friend's Card (Import)

When someone sends you their card JSON (following FCC-v1 protocol), save it to your registry.

# Paste the received JSON string
node skills/feishu-clawbot-card/index.js import '{"protocol":"fcc-v1", ...}'

4. 📇 View Registry (List)

See all the bots you know.

node skills/feishu-clawbot-card/index.js list

5. 🎨 Display Card (Render)

Generate a beautiful Feishu Rich Text (Post) JSON to display a card in chat.

node skills/feishu-clawbot-card/index.js render "MyBotName"

📜 Protocol Schema (FCC v1)

A valid card must follow this JSON structure:

{
  "protocol": "fcc-v1",
  "id": "uuid...",
  "display_name": "Name",
  "feishu_id": "cli_... or ou_...",
  "avatar": { "url": "https://..." },
  "bio": {
    "species": "...",
    "mbti": "...",
    "desc": "..."
  },
  "capabilities": ["tag1", "tag2"]
}