Xpersona
V

Vibe Card

CLAWHUB · Unverified

Agent 原生社交名片生成、管理和分享，以及智能花名册（通讯录管理器）。当用户提到名片、花名册、通讯录、联系人、Vibe Card、vibe-card 时使用。具体触发场景包括：安装 Vibe Card、建花名册、生成/更新/发名片、注册 Vibe Card、录入/查询/编辑联系人、同步花名册、收到包含 vib...

62
Rank
84
Safety
965
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 965 downloads reported by the source. Last updated 10/12/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: low.

clawhub skill install s170cs7f2aj74kx4kbazqpscgh85paq9:vibe-card
  1. Install using `clawhub skill install s170cs7f2aj74kx4kbazqpscgh85paq9:vibe-card` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. Review the upstream CLAWHUB listing at https://clawhub.ai/sxd20010606-cmd/vibe-card before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-sxd20010606-cmd-vibe-card/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

120,050 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: vibe-card
description: "Agent 原生社交名片生成、管理和分享，以及智能花名册（通讯录管理器）。当用户提到名片、花名册、通讯录、联系人、Vibe Card、vibe-card 时使用。具体触发场景包括：安装 Vibe Card、建花名册、生成/更新/发名片、注册 Vibe Card、录入/查询/编辑联系人、同步花名册、收到包含 vibe-card:// 协议的消息时自动识别并保存他人名片。定期检查花名册中联系人的名片是否有更新，有变化时拉取最新信息到本地。"
metadata:
  version: "4.0.0"
  author: "阿东 & 阿东的赛博虾"
---

# Vibe Card

> 你的 Agent 原生名片。Agent 从记忆提炼信息，帮你维护动态名片和智能花名册。
> 名片可通过三段式文本块在 IM 中传递，对方的 Agent 自动识别并保存。

## 快速开始

1. 安装 — 说"安装 Vibe Card"，初始化数据文件
2. 生成 — 说"生成我的名片"，Agent 从记忆提炼信息，确认后自动上线（首次会自动注册）

| 触发指令 | 行为 |
|----------|------|
| "安装 Vibe Card" / "初始化" | 初始化 data/ 目录下三个 JSON 文件（config.json、profile.json、contacts.json），然后读取 assets/onboarding.txt 原样输出，不做改写。已初始化则跳过初始化，直接输出 onboarding.txt |
| "注册 Vibe Card" | （兼容入口）已注册则输出服务菜单，未注册则提示"直接说'生成我的名片'即可，会自动注册" |
| "录入 {name}" / "新建联系人 {name}" | 打开录入流程 |
| "查花名册" / "查联系人" | 搜索花名册 |
| "生成我的名片" / "更新名片" | 生成或更新名片（见操作流程 §4） |
| "看看名片" / "发一下我的名片" / "发名片" | 输出三段式文本块（已上线读取 assets/share-template.txt，已安装未生成则引导） |
| "同步花名册" | 检查花名册中联系人的最新信息 |
| 收到 `vibe-card://` 开头的消息 | 自动识别并保存他人名片 |

## 状态判断

先判断用户当前状态，再路由到对应流程：

| 状态 | 判断条件 |
|------|---------|
| 未安装 | data/ 目录不存在 |
| 已安装(未生成) | data/ 存在 + profile.json.owner.name 为空 |
| 已生成(未上线) | profile.json 有内容 + config.json 无 user_id |
| 已上线 | profile.json 有内容 + config.json 有 user_id |

### 指令路由表

| 用户说 | 已安装(未生成) | 已生成(未上线) | 已上线 |
|--------|---------------|---------------|-------|
| "生成名片" | 走 §4 创建流程 | 引导完成发布（§4 步骤 7 的发布链路） | 读取 assets/already-has-card.txt，填充 {name}、{title}、{one_liner}、{current_focus}、{user_id} 后原样输出 |
| "看看名片" / "发名片" | 还没生成，说"先生成我的名片" | 引导完成发布 | 读取 assets/share-template.txt，填充后原样输出 |
| "编辑名片"/"更新名片" | 还没生成，说"先生成我的名片" | 引导完成发布 | 走 §4 更新流程 |
| "查花名册" | contacts.json 为空 → 读取 assets/contacts-empty.txt 原样输出；有数据 → 展示联系人列表 | 同左 | 同左 |
| "同步花名册" | 无 user_id，提示先生成 | 无 user_id，提示发布 | POST /sync（见 §7） |
| 其他指令 | 读取 assets/onboarding.txt 原样输出 | 引导完成发布 | 展示服务菜单 |

> "已生成(未上线)"是边界状态，生成即发布。如果出现，统一引导完成发布。

## 操作流程

### 1. 注册（兼容入口）

1. 已注册 → 输出服务菜单（5 个可执行操作）
2. 未注册 → 提示"直接说'生成我的名片'即可，确认后会自动注册并上线"

### 2. 录入联系人

社交姓名确认规则、必填字段和边界处理见 [references/manual.md](references/manual.md)"录入联系人"段落。

### 3. 查询花名册

1. 读取 contacts.json，输出所有联系人列表
2. 用户提到某个名字 → 模糊搜索 name / agent_name，输出匹配结果
3. 花名册为空 → 读取 assets/contacts-empty.txt 原样输出

### 4. 生成/更新名片

1. 检查 config.json 是否已初始化 → 未初始化则提示"先说'安装 Vibe Card'"
2. 读取 profile.json
   - 首次（owner.name 为空）：Agent 从记忆提炼信息，生成预览
   - 已有内容：展示当前名片，询问"要修改哪些信息？"
3. Agent 从记忆提炼信息，生成名片预览，等待用户确认
4. 用户确认 → Agent 执行以下链路：
   a. 检查 config.json 中是否有 api_key 和 user_id
   b. 没有 → 自动调注册接口（用 profile.json 中的 name 和 agent_name）→ 将返回的 user_id 和 api_key 写入 config.json
   c. 保存 profile.json
   d. 调发布接口将名片推送到服务器
   e. 首次生成 → 读取 assets/onboard-generated.txt，填充 {name}、{title}、{one_liner}、{current_focus}、{user_id} 后原样输出
   f. 非首次更新 → 输出"那我保存名片了哈 ✅ 你的名片已上线：https://www.adonghub.cn/{user_id}"
   g. 首次发布 → 引导创建定时同步任务（具体命令见 [references/manual.md](references/manual.md)"定时同步"段落）
5. 推送失败 → 本地仍保存，提示稍后重试

### 5. 发名片

读取 assets/share-template.txt，用 profile.json 和 config.json 中的字段值替换对应占位符

_meta.json

{
  "ownerId": "kn78x1btfj3thhezb2cxv5qgn585pvxh",
  "slug": "vibe-card",
  "version": "4.0.0",
  "publishedAt": 1778253827997
}

references/data-format.md

# Vibe Card 数据格式规范

> 本文档描述 Vibe Card V4.0.0 中所有 JSON 数据文件的格式规范。

## Contents
- 数据目录结构
- config.json — 服务器连接配置
- profile.json — 用户名片数据
- contacts.json — 花名册
- 服务器 API 返回格式（GET /card、POST /sync）

---

### 数据目录结构

```
data/
├── config.json      # 服务器连接配置
├── profile.json     # 用户名片数据
└── contacts.json    # 花名册
```

---

### config.json

服务器连接配置，由 Agent 维护。

```json
{
  "version": "1.0",
  "server": {
    "endpoint": "https://www.adonghub.cn",
    "api_key": "",
    "user_id": ""
  },
  "sync": {
    "last_sync_at": null
  }
}
```

**字段说明：**

| 字段 | 类型 | 说明 |
|------|------|------|
| version | string | 数据格式版本 |
| server.endpoint | string | 服务器地址 |
| server.api_key | string | 注册后服务器返回的凭证 |
| server.user_id | string | 注册后服务器返回的用户 ID |
| sync.last_sync_at | string\|null | 上次同步时间（ISO 时间戳），用于 since 参数 |

**初始化：** api_key 和 user_id 为空，首次生成名片时自动注册填充。

---

### profile.json

用户名片数据，由 Agent 从记忆提炼并维护。

```json
{
  "version": "1.0",
  "owner": {
    "name": "张小明",
    "agent_name": "小明的赛博虾",
    "title": "示例科技有限公司联合创始人",
    "one_liner": "专注于人工智能产品创新"
  },
  "current_focus": ["大语言模型应用", "AI Agent 开发"],
  "background": "连续创业者，专注于技术创新与产品开发。",
  "personal_notes": "近期在探索 AI Agent 生态，考虑做一个新产品验证想法",
  "links": {
    "wechat": "xiaoming_wechat",
    "email": "zhangxiaoming@example.com"
  },
  "tiers": {
    "public": {
      "fields": ["name", "title", "one_liner", "links", "current_focus"]
    },
    "full": null,
    "close": null
  },
  "published_at": null,
  "updated_at": ""
}
```

**字段说明：**

| 字段 | 类型 | 说明 |
|------|------|------|
| owner.name | string | 用户姓名 |
| owner.agent_name | string | Agent 名字 |
| owner.title | string | 职位/身份 |
| owner.one_liner | string | 一句话介绍 |
| current_focus | string[] | 当前关注点（公开推送） |
| background | string | 背景介绍（本地存储，不上传服务器） |
| personal_notes | string | 个人笔记（本地存储，不上传服务器） |
| links | object | 联系方式（key 为渠道名：wechat/email/feishu/phone/twitter/linkedin/github/website/weibo） |
| tiers.public.fields | string[] | 公开推送的字段白名单 |
| published_at | string\|null | 首次发布时间 |
| updated_at | string | 最后更新时间 |

**隐私规则：**
- 推送服务器时，只推送 `tiers.public.fields` 中列出的字段
- `background`：本地存储，不上传服务器
- `personal_notes`：本地存储，不上传服务器

---

### contacts.json

花名册，存储用户收录的联系人。

```json
{
  "version": "1.0",
  "owner": {
    "name": "张小明",
    "agent_name": "小明的赛博虾"
  },
  "contacts": [
    {
      "name": "李明",
      "agent_name": "李明的 Agent",
      "title": "前端工程师",
      "how_we_met": "2026年5月在技术社区认识",
      "tags": ["技术", "AI"],
      "links": {},
      "notes": "",
      "server_user_id": "liming",
      "manually_edited_fields": [],
      "created_at": "2026-04-28T14:00:00+08:00",
      "updated_at": "2026-04-28T14:00:00+08:00"
    }
  ]
}
```

**联系人字段说明：**

| 字段 | 类型 | 说明 |
|------|------|------|
| name | string | 联系人姓名 |
| agent_name | string | 联系人的 Agent 名字 |
| title | string | 职位 |
| how_we_met | string | 认识场景 |
| tags | string[] | 标签 |
| links | object | 联系方式 |
| notes | string | 备注笔记 |
| server_user_id | string\|null | 服务器端用户 ID（收名片后自动填充，用于同步） |
| manually_e

references/manual.md

# Vibe Card — 完整操作手册

> 本文档供 Agent 在执行具体操作时参考，包含详细的 if-else 分支、话术和边界处理。

## Contents
- 1. 安装 Vibe Card
- 2. 注册 Vibe Card（兼容入口）
- 3. 录入联系人
- 3.5. 编辑联系人
- 4. 查询花名册
- 5. 生成/更新名片
- 6. 发名片
- 7. 收名片
- 8. 同步花名册
- 9. 定时同步

---

### 1. 安装 Vibe Card

1. 检查 data/ 目录下是否已有 config.json、profile.json、contacts.json → 全部存在则读取 assets/onboarding.txt 原样输出
2. 缺失文件 → 用默认模板创建：
   - config.json：`{"version":"1.0","server":{"endpoint":"https://www.adonghub.cn","api_key":"","user_id":""},"sync":{"last_sync_at":null}}`
   - profile.json：`{"version":"1.0","owner":{"name":"","agent_name":"","title":"","one_liner":""},"current_focus":[],"background":"","personal_notes":"","links":{},"tiers":{"public":{"fields":["name","title","one_liner","links","current_focus"]},"full":null,"close":null},"published_at":null,"updated_at":""}`
   - contacts.json：`{"version":"1.0","owner":{"name":"","agent_name":""},"contacts":[]}`
3. 读取 assets/onboarding.txt，原样输出，不做改写

### 2. 注册 Vibe Card（兼容入口）

1. 检查 config.json 中是否已有 user_id 和 api_key
   - 已有 → 输出服务菜单：
     > 🎴 你已经有 Vibe Card 了。你可以回复：
     > • "更新名片" — 更新或修改你的名片
     > • "发一下我的名片" — 获取文本版分享给别人
     > • "录入 XXX" — 记一个新联系人
     > • "查花名册" / "搜索 XXX" — 查找联系人
     > • "同步花名册" — 更新联系人的最新信息
   - 没有 → 提示"现在注册和发布是自动的。直接说'生成我的名片'，确认后我会自动注册并上线。"

### 3. 录入联系人

1. 确认社交姓名：
   - 检查 contacts.json 中是否已有同名联系人（模糊匹配 name 和 agent_name）
   - 已有 → "花名册里已经有 {name} 了，要更新信息还是新建另一个？"
   - 不确定名字 → 确认后再录入，不猜
2. Agent 从记忆中主动提取已知信息（title、company、how_we_met 等），不逐项追问
3. 写入 contacts.json，生成结构：
   ```json
   {
     "name": "张威",
     "agent_name": "张威的赛博虾",
     "title": "独立开发者",
     "how_we_met": "2026年4月通过东东推荐认识",
     "tags": ["技术", "AI"],
     "links": {},
     "notes": "",
     "created_at": "2026-04-28T14:00:00+08:00",
     "updated_at": "2026-04-28T14:00:00+08:00"
   }
   ```
4. 输出确认："已录入 {name}。"

### 3.5. 编辑联系人

用户说"改一下某某的职位"/"更新张三的备注"等编辑联系人请求时：

1. 在 contacts.json 中找到对应联系人（模糊匹配 name / agent_name）
2. 更新用户指定的字段
3. 将被修改的字段名追加到该联系人的 `manually_edited_fields` 数组（追加，不是覆盖）。例：用户改了 title → `["title"]`；再改 notes → `["title", "notes"]`
4. 输出确认："已更新 {name} 的 {字段名}。"

### 4. 查询花名册

1. contacts.json 为空 → 读取 assets/contacts-empty.txt 原样输出
2. 有数据 → 列表输出，格式：`{name}（{title}）`，每行一人
3. 用户搜索某个名字 → 模糊匹配 name / agent_name / title，输出匹配结果
4. 搜索无结果 → "花名册中没有找到 {关键词}。"

### 5. 生成/更新名片

1. 检查 config.json 是否已初始化 → 未初始化则提示"先说'安装 Vibe Card'"
2. 读取 profile.json
   - 首次（owner.name 为空）：Agent 从记忆提炼信息，生成预览
   - 已有内容：展示当前名片，询问"要修改哪些信息？"
3. Agent 提炼信息后生成预览：
   - name、title、one_liner（必填）
   - current_focus（从记忆中提取当前关注点）
   - links（联系方式：wechat / email / feishu / phone 等）
   - personal_notes、background（本地保存，不推送）
4. 等待用户确认，多轮调整直到用户满意
5. 社交姓名确认：如果 profile.json 的 owner.name 为空且 Agent 从记忆中提取了名字，需要确认。用户明确说"就这样"/"用这个"后才写入
6. profile.json 的 owner.name 和 contacts.json 的 owner.name 应保持一致
7. 用户说"可以了"/"就这样"/"确认" → Agent 保存并上线：
   - 写入 profile.json
   - **前置检查**：读取 config.json，检查是否有 api_key 和 user_id
   - **未注册** → 自动调注册接口，请求体 `{name: profile.json的owner.name, agent_name: profile.json的owner.agent_name}`，将返回的 user_id 和 a

skill-card.md

## Description:

Vibe Card helps an agent generate, manage, share, receive, and synchronize social contact cards and a local contact book.

This skill is ready for commercial/non-commercial use.

## Publisher:

[sxd20010606-cmd](https://clawhub.ai/user/sxd20010606-cmd)

### License/Terms of Use:

MIT-0

## Use Case:

External users and their agents use this skill to create a shareable personal profile card, save received Vibe Card messages, manage contacts, and synchronize contact updates.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill can publish selected personal profile fields to adonghub.cn.

Mitigation: Confirm the fields that will be published before first use and keep sensitive notes in the local-only fields described by the data format.

Risk: The skill can auto-import contact cards from received Vibe Card messages.

Mitigation: Review cards from untrusted messages before saving or merging them into the contact book.

Risk: The skill can fetch and synchronize contact updates from a remote service.

Mitigation: Keep the server endpoint pinned to the intended HTTPS origin and review sync results before accepting conflict resolutions.

Risk: The skill may ask to create a recurring OpenClaw sync task.

Mitigation: Review the scheduled task command and know how to list or remove the sync job before enabling it.

## Reference(s):

- [Vibe Card Data Format](references/data-format.md)
- [Vibe Card Manual](references/manual.md)
- [ClawHub Skill Page](https://clawhub.ai/sxd20010606-cmd/skills/vibe-card)
- [AdongHub Service](https://www.adonghub.cn)

## Skill Output:

**Output Type(s):** [Text, Markdown, Configuration, Shell commands, Guidance]

**Output Format:** [Markdown and text responses with JSON file updates and optional shell commands]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Creates and updates local config.json, profile.json, and contacts.json files; may publish selected profile fields and synchronize contacts with a remote HTTPS service.]

## Skill Version(s):

4.0.0 (source: server release metadata, SKILL.md metadata, package.json)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Sponsored

Ads related to Vibe Card and adjacent AI workflows.