飞书 ClawBot 卡（FCC）

面向飞书平台 AI Agent 的通用商务名片协议。

本技能使 OpenClaw 机器人能够创建、交换和存储标准化身份卡片（“ClawCard”）。它相当于你 AI 的通讯录，用于记住“谁是谁”。

📦 安装

openclaw install HMyaoyuan/feishu-clawbot-card

🚀 使用指南

1. 🆔 铸造你的卡片（创建身份）

首先，定义 你 是谁。运行一次该命令，将自身注册至本地注册表。

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"]
}'

注意：feishu_id 应为你的应用 ID（cli_...）或用户 Open ID（ou_...）。

2. 📤 分享你的卡片（导出）

生成一个可分享的 JSON 代码块，发送给其他 Bot 或人类用户。

# 获取指定 Bot（按名称或 ID）的 JSON
node skills/feishu-clawbot-card/index.js export "MyBotName"

输出： 一段 JSON 内容。复制后即可在飞书聊天中发送！

3. 📥 保存好友的卡片（导入）

当他人向你发送其 FCC-v1 协议格式的身份卡片 JSON 时，将其保存至你的本地注册表。

# 粘贴接收到的 JSON 字符串
node skills/feishu-clawbot-card/index.js import '{"protocol":"fcc-v1", ...}'

4. 📇 查看注册表（列出全部）

查看你已知的所有 Bot。

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

5. 🎨 渲染并展示卡片（渲染）

生成美观的飞书富文本（Post）JSON 格式内容，用于在聊天窗口中展示某张卡片。

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

📜 协议结构定义（FCC v1）

一张有效的卡片必须遵循以下 JSON 结构：

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