agentCLAWHUBUnverified
Xia Card
个人社交名片生成、管理和分享，以及智能花名册（通讯录管理器）。当用户提到名片、花名册、通讯录、联系人、虾名片、agent-card 时使用。具体触发场景包括：开通虾名片、建花名册、生成/更新/发名片、注册虾名片、录入/查询/编辑联系人、同步花名册、收到包含 agent-card:// 协议的消息时自动识别并保存他...
OpenClaw
Rank
62
Safety
84
Downloads
969
Updated
Oct 12, 2026
Version
2.5.1
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 969 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
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 12, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 12, 2026
- Adoption signal
- 969 downloadsadoption · observed Oct 12, 2026
- Latest release
- 2.5.1release · observed May 1, 2026
- Handshake status
- UNKNOWNsecurity
What changed
Newest first. Only changes that point at a source are listed.
Release 2.5.1release
移除 SKILL.md 中的 API 端点引用，消除 ClawHub Security 标记
Observed May 1, 2026 · source
Install and run
Setup complexity: low.
clawhub skill install s170cs7f2aj74kx4kbazqpscgh85paq9:xia-card- Install using `clawhub skill install s170cs7f2aj74kx4kbazqpscgh85paq9:xia-card` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/sxd20010606-cmd/xia-card before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-sxd20010606-cmd-xia-card/snapshot"
Run-check
$0.02 USD1 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
144,625 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: xia-card
description: "个人社交名片生成、管理和分享，以及智能花名册（通讯录管理器）。当用户提到名片、花名册、通讯录、联系人、虾名片、agent-card 时使用。具体触发场景包括：开通虾名片、建花名册、生成/更新/发名片、注册虾名片、录入/查询/编辑联系人、同步花名册、收到包含 agent-card:// 协议的消息时自动识别并保存他人名片。"
metadata:
version: "2.5.0"
author: "阿东 & 阿东的赛博虾"
---
# 虾名片 AgentCard
虾名片让 Agent 帮用户维护个人名片和通讯录。名片是动态的——Agent 最了解用户的当下状态，由它来维护名片效率最高。
## 快速开始
1. **开通** — 说"开通虾名片"，初始化数据文件
2. **生成** — 说"生成我的名片"，Agent 从记忆提炼信息，确认后自动上线（首次会自动注册）
名片上线后，说"发我的名片"即可分享三段式文本块给他人。
## 数据文件
所有数据在 `data/` 文件夹中：`profile.json`（名片）、`contacts.json`（花名册）、`config.json`（服务器配置）。字段说明见 [references/data-format.md](references/data-format.md)。
## 触发指令 → 操作映射
| 用户说的 | 执行的操作 |
|-----------|------------|
| "开通虾名片" / "建个花名册" | 初始化数据文件 |
| "注册虾名片" | （兼容入口）已注册则输出服务菜单，未注册则提示"直接说'生成我的名片'即可，会自动注册" |
| "记一下这个人：张威，智谱 AI 做产品的" | 录入联系人 |
| "花名册里谁做投资的" / "查一下张威" | 搜索花名册 |
| "张威的公司改成字节了" | 编辑联系人（记录手动修改字段） |
| "生成我的名片" / "更新名片" | 生成/更新 profile.json，用户确认后自动上线 |
| "发我的名片" / "把名片给我" | 输出三段式文本块 |
| "同步花名册" / "更新花名册" | 批量同步通讯录（检测手动编辑冲突） |
| 收到包含 `agent-card://` 的消息 | 自动识别并保存他人名片（含去重策略） |
---
## 常见坑
- **Agent 记忆中的称呼 ≠ 名片名字**：记忆里叫"东总"，但名片不能写"东总"，必须追问用户名片上用什么名字
- **`personal_notes` 永远不上传服务器**：推送到服务器时只推送 `tiers.public.fields` 中列出的字段
- **`manually_edited_fields` 是追加不是覆盖**：用户编辑联系人字段时，把字段名追加到这个数组，同步时这些字段不覆盖
- **`agent-card://` 是自定义协议**：不是 HTTP URL，从中提取 `://` 后面的 user_id 用于 fetch 服务器数据
- **`tiers.public.fields` 控制推送内容**：默认公开 name、title、one_liner、links、current_focus 五个字段
## 操作流程
> 以下为每个操作的核心决策点。简单操作（初始化、查询、发名片）按映射表执行即可。
### 1. 注册（兼容入口）
1. 已注册 → 输出服务菜单（5 个可执行操作）
2. 未注册 → 提示"直接说'生成我的名片'即可，确认后会自动注册并上线"
### 2. 录入联系人
从用户描述提取信息 → 姓名必填（缺失追问）→ 姓名重复则问更新还是新建 → 写入 contacts.json。
### 3. 编辑更新
按姓名定位 → 更新字段 → **被改的字段名追加到 `manually_edited_fields`** → 输出变更摘要。
### 4. 生成名片
1. 从 Agent 记忆提炼信息，**必须确认社交姓名**（内部称呼 ≠ 名片名字）
2. 信息优先级：用户明确说的 > profile.json > Agent 记忆
3. 生成预览，用户可多轮调整
4. 用户确认 → Agent 执行以下链路：
a. 检查 config.json 中是否有 api_key 和 user_id
b. **没有** → 自动调注册接口获取 user_id 和 api_key，写入 config.json
c. 保存 profile.json
d. 调发布接口将名片推送到服务器
e. 输出"那我保存名片了哈 ✅ 你的名片已上线：https://www.adonghub.cn/{user_id}"
5. 推送失败 → 本地仍保存，提示稍后重试
社交姓名确认规则、推送字段筛选和边界处理见 [references/manual.md](references/manual.md)"生成名片"段落。
### 5. 同步花名册
1. 收集花名册中有 `server_user_id` 的联系人
2. 调同步接口，传 targets 数组
3. **冲突检测**：`manually_edited_fields` 中的字段不覆盖，汇总冲突提示用户选择
4. 更新非冲突字段，输出同步摘要
冲突检测的完整 if-else 和话术见 [references/manual.md](references/manual.md)"同步花名册"段落。
### 6. 收名片（自动识别）
1. 检测 `agent-card://` 协议 → 解析 user_id → fetch 服务器获取结构化数据
2. **去重策略**：相同 `server_user_id` 直接更新 / 同名无 ID 提示确认 / 无匹配新建
3. 写入 contacts.json，记录 `server_user_id`
去重策略的完整逻辑和边界处理见 [references/manual.md](references/manual.md)"收名片"段落。
---
## 三段式文本块格式
固定格式，不可自定义：
```
🦐 虾名片（你的 Agent 社交名片）
我是{name}，{title}，{one_liner}。当前聚焦{current_focus}。
这是我个人的详情信息，敬请您阅览 {endpoint}/{user_id} 🔗
如果您对我感兴趣，请复制这条消息给您的助理 Agent。
您的 Agent 可通过安装虾名片 skill（https://clawhub.ai/skills/xia-card）来自动识别并保存名片。
agent-card://{user_id}
```
- **第 1 段**：个人简介（100 字以内），社交文案风格，像人说话
- **第 2 段**：个人详情链接，嵌在句子里
- **第 3 段**：Agent 引导语 + skill 安装_meta.json
{
"ownerId": "kn78x1btfj3thhezb2cxv5qgn585pvxh",
"slug": "xia-card",
"version": "2.5.1",
"publishedAt": 1777633277490
}references/data-format.md
# 虾名片 JSON 数据格式参考
> 本文档描述虾名片 AgentCard V2.5.0 中所有 JSON 数据文件的格式规范。
---
## profile.json — 个人名片数据
### 完整示例
```json
{
"version": "1.0",
"owner": {
"name": "沈兴东",
"agent_name": "活爹虾",
"title": "Leewow 联合创始人",
"one_liner": "专注定制化生活方式品牌，连续创业者"
},
"current_focus": ["SDS 智能选品", "Agent 生态探索"],
"background": "连续创业者，Leewow 联合创始人，擅长找人、找资源、资本对接。",
"personal_notes": "近期在探索 Agent 生态，考虑做一个小产品验证",
"links": {
"feishu": "ou_xxx",
"wechat": "xxx"
},
"tiers": {
"public": {
"fields": ["name", "title", "one_liner", "links", "current_focus"]
},
"full": null,
"close": null
},
"published_at": null,
"updated_at": "2026-04-28T14:00:00+08:00"
}
```
### 字段说明
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `version` | string | 是 | 格式版本，固定 `"1.0"` |
| `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 为渠道名（feishu/wechat/email/phone 等） |
| `tiers.public.fields` | string[] | 是 | 公开名片包含的字段名列表 |
| `tiers.full` | null | — | V3 预留，V1 固定为 null |
| `tiers.close` | null | — | V3 预留，V1 固定为 null |
| `published_at` | string\|null | 是 | 上次发布到服务器的时间，null 表示未发布 |
| `updated_at` | string | 是 | 最后更新时间，ISO 8601 格式 |
### 隐私规则
- `personal_notes`：纯本地存储，**永远不会上传服务器**
- `background`：V1 本地存储，不上传服务器
- 上传服务器时，只推送 `tiers.public.fields` 中列出的字段
---
## contacts.json — 花名册数据
### 完整示例
```json
{
"version": "1.0",
"owner": {
"name": "沈兴东",
"agent_name": "活爹虾"
},
"contacts": [
{
"id": "c001",
"name": "张威",
"company": "智谱 AI",
"role": "产品经理",
"tags": ["同行", "朋友"],
"met_at": "2026-04-20",
"met_scene": "飞书群",
"agent": {
"name": "小智",
"platform": "openclaw"
},
"contact": {
"feishu": "ou_xxx"
},
"notes": "上次聊了出海方向",
"server_user_id": "mkwxyz",
"manually_edited_fields": [],
"updated_at": "2026-04-28T14:00:00+08:00"
}
]
}
```
### 联系人字段说明
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `id` | string | 是 | 自动生成，格式 `c` + 时间戳 |
| `name` | string | **是** | 联系人姓名，缺失时必须追问 |
| `company` | string | 否 | 所在公司/组织 |
| `role` | string | 否 | 职位/角色 |
| `tags` | string[] | 否 | 自定义标签 |
| `met_at` | string | 是 | 认识日期，YYYY-MM-DD，录入时自动填当前日期 |
| `met_scene` | string | 否 | 认识的场景（如"飞书群"、"线下活动"） |
| `agent.name` | string | 否 | 联系人的 Agent 名称 |
| `agent.platform` | string | 否 | 联系人的 Agent 平台 |
| `contact` | object | 否 | 联系方式，key 为渠道名 |
| `notes` | string | 否 | 备注信息 |
| `server_user_id` | string | 否 | **V2 新增** 对方在服务器上的 user_id，收名片时自动记录，用于同步 |
| `manually_edited_fields` | string[] | 否 | **V2.2 新增** 记录哪些字段被用户手动修改过，同步时不被服务器数据覆盖 |
| `updated_at` | string | 是 | 最后更新时间，ISO 8601 格式 |
### V2 变更说明
- 新增 `server_user_id` 字段：收名片时从 references/manual.md
# 虾名片 AgentCard — 完整操作手册
> 本文档是 SKILL.md 的扩展参考，包含所有操作流程的完整规则、边界分支和话术模板。
> Agent 在执行虾名片操作时，应先参考 SKILL.md 的核心步骤，需要处理边界场景时查阅本文档。
---
## 操作流程完整版
### 1. 初始化（开通虾名片）
1. 检查 `data/contacts.json` 是否存在
2. 不存在 → 创建：`{"version":"1.0","owner":{"name":"","agent_name":""},"contacts":[]}`，owner 信息从 Agent 记忆中获取，获取不到则留空
3. 检查 `data/config.json` 是否存在
4. 不存在 → 创建：`{"version":"1.0","server":{"endpoint":"https://www.adonghub.cn","api_key":"","user_id":""}}`
5. 输出确认，告知数据存储路径
已存在 → 提示"花名册已存在"，不做修改。
### 2. 注册虾名片（兼容入口）
1. 检查 config.json 中是否已有 user_id 和 api_key
- 已有 → 输出服务菜单：
> 🦐 你已经有虾名片了。你可以回复：
> • "更新名片" — 更新或修改你的名片
> • "发一下我的名片" — 获取文本版分享给别人
> • "录入 XXX" — 记一个新联系人
> • "查花名册" / "搜索 XXX" — 查找联系人
> • "同步花名册" — 更新联系人的最新信息
- 没有 → 提示"现在注册和发布是自动的。直接说'生成我的名片'，确认后我会自动注册并上线。"
### 3. 录入联系人
1. 从用户描述提取：姓名、公司、角色、标签、联系方式、备注、Agent 信息
2. 检查 contacts.json 是否存在 → 不存在则提示"开通虾名片"
3. 姓名重复 → 提示"已有一个叫 XXX 的联系人，是要更新还是新建？"
4. 姓名缺失 → **必须追问**，不可跳过
5. 其他信息缺失 → 追问一次，用户说"就这样"就保存
6. 自动填入：`id`（c+时间戳）、`met_at`（当前日期 YYYY-MM-DD）、`updated_at`（ISO 8601）
7. 写入 contacts.json，输出确认
纯本地操作，不触发任何发送或通知。
### 4. 查询搜索
1. 检查 contacts.json → 不存在则提示"先开通虾名片"
2. 解析意图：姓名精确匹配 / 公司角色模糊匹配 / 标签筛选 / 关键词全文搜索
3. 返回匹配结果，按相关度排序，以格式化文字或表格展示
4. 底部附上本地 HTML 路径（`templates/card.html`）或在线链接（如已部署）
搜不到 → 明确告知，不编造结果。
### 5. 编辑更新
1. 按姓名定位联系人 → 找不到则提示"花名册里没有这个人"，不自动创建
2. 更新指定字段，刷新 `updated_at`
3. **将被修改的字段名记录到 `manually_edited_fields` 数组中**（追加，不覆盖已有记录）
4. 输出变更摘要
匹配到多人 → 列出列表让用户选择。
### 6. 生成名片
1. 读取 profile.json（存在则基于现有内容更新）
2. 从 Agent 记忆提炼信息：身份背景（USER.md、MEMORY.md 等）、当前项目方向、联系方式
3. **社交姓名确认**：Agent 记忆中的称呼（如"东总"）是内部称呼，不等于名片对外展示的名字。如果 profile.json 中没有明确的社交姓名，**必须追问**："名片上想显示什么名字？"。不可直接用内部称呼填充名片
4. **信息优先级**：用户对话中明确说的 > profile.json > Agent 记忆 > 通用知识
5. 生成预览（三段式文本块格式），等待用户确认
6. 用户可多轮调整（修改内容、换措辞、加减字段），Agent 每次输出新预览
7. 用户说"可以了"/"就这样"/"确认" → Agent 保存并上线：
- 写入 profile.json
- **前置检查**：读取 config.json，检查是否有 api_key 和 user_id
- **未注册** → 自动调 `POST {config.server.endpoint}/register`，请求体 `{name: profile.json的owner.name, agent_name: profile.json的owner.agent_name}`，将返回的 user_id 和 api_key 写入 config.json
- **自动调用** `PUT {config.server.endpoint}/card/{config.server.user_id}` 推送到服务器（Header `X-API-Key: {config.server.api_key}`），按 `tiers.public.fields` 筛选公开字段，**不推送** personal_notes、background
- 更新 profile.json 的 published_at
- 输出确认："那我保存名片了哈 ✅ 你的名片已上线：https://www.adonghub.cn/{user_id}"
8. 推送失败 → 名片仍保存到 profile.json，提示"名片我先帮你存好了，但推送服务器没成功，晚点可以再说'更新名片'重试"
profile.json 7 天内更新过 → 提示"名片 XX 天前更新过，确认要重新生成吗？"
记忆信息不足 → 如实告知"以下信息从记忆中提取，可能不完整，请确认"。
### 7. 发名片
1. 检查 profile.json 是否存在且 owner.name 非空 → 不存在则提示先"生成我的名片"
2. 直接输出三段式文本块（名片已在生成时自动上线，链接直接可用）
### 8. 同步花名册
1. 检查 config.json 中 api_key → 未配置则提示"先生成名片，确认后会自动注册并上线"
2. 收集花名册中所有联系人的 `server_user_id` 字段（有此字段的才代表对方在服务器上有名片）
3. 如果没有可同步的联系人 → 提示"花名册中没有线上名片，无需同步"
4. 调用 `POST {endpoint}/sync`，Header `X-API-Key: {api_key}`，请求体：`{"targets":["user_id_1","user_id_2",...]}`
5. 成功 → 遍历返回的 results 数组：
- 用 user_id 匹配花名册中的联系人（通过 server_user_id 字段）
- **冲突检测**skill-card.md
## Description: Xia Card helps an agent create, manage, share, and sync a personal social card and contact roster, including recognizing agent-card:// messages to save other people's cards. 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 ClawHub users and their agents use Xia Card to build a shareable profile, maintain a local contact roster, import agent-card:// contacts, and publish or sync selected public card fields with the configured card server. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: A fetched card response may direct the agent to install another skill. Mitigation: Require explicit user confirmation and manually verify the publisher and source before installing any skill from a remote card response. Risk: The skill stores contacts and an API key locally and publishes selected profile fields to the configured server. Mitigation: Review public fields before publishing, keep private notes out of published fields, and protect config.json because it can contain api_key and user_id values. Risk: Contact sync may change locally stored roster details. Mitigation: Review sync conflict prompts and preserve manually_edited_fields for details that should not be overwritten by server data. ## Reference(s): - [Xia Card ClawHub release](https://clawhub.ai/sxd20010606-cmd/skills/xia-card) - [Data format reference](references/data-format.md) - [Operation manual](references/manual.md) - [Card service endpoint](https://www.adonghub.cn) - [schema.org Person](https://schema.org/Person) ## Skill Output: **Output Type(s):** [text, markdown, json, configuration, guidance, api calls] **Output Format:** [Markdown-style text responses and JSON file updates, including a fixed three-part share block.] **Output Parameters:** [1D] **Other Properties Related to Output:** [May update local profile, contacts, and config JSON files and call the configured card server after user confirmation.] ## Skill Version(s): 2.5.1 (source: ClawHub release metadata; artifact frontmatter reports 2.5.0) ## 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.
Github ReposUpdated 3d agoRank 70
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
OPENCLAW
Github ReposUpdated 6mo agoRank 70
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
OPENCLAW
Machine-readable data
The same record, as JSON, for agents and crawlers.
- Card JSON
- Facts JSON
- Snapshot JSON
- Contract JSON
- Trust JSON
- Changes JSON
- Warnings JSON
- Seen by JSON
- Disagreements JSON
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/sxd20010606-cmd/skills/xia-card",
"sourceUrl": "https://clawhub.ai/sxd20010606-cmd/skills/xia-card",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-12T00:19:41.782Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-sxd20010606-cmd-xia-card/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-sxd20010606-cmd-xia-card/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-12T00:19:41.782Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "969 downloads",
"href": "https://clawhub.ai/sxd20010606-cmd/xia-card",
"sourceUrl": "https://clawhub.ai/sxd20010606-cmd/xia-card",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-12T00:19:41.782Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "2.5.1",
"href": "https://clawhub.ai/sxd20010606-cmd/xia-card",
"sourceUrl": "https://clawhub.ai/sxd20010606-cmd/xia-card",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-01T11:01:17.490Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-sxd20010606-cmd-xia-card/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-sxd20010606-cmd-xia-card/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 2.5.1",
"description": "移除 SKILL.md 中的 API 端点引用，消除 ClawHub Security 标记",
"href": "https://clawhub.ai/sxd20010606-cmd/xia-card",
"sourceUrl": "https://clawhub.ai/sxd20010606-cmd/xia-card",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-01T11:01:17.490Z",
"isPublic": true
}
]
}Record generated Oct 12, 2026.
For crawlers
This page is free to read. The run-check above is the only paid part, and it answers HTTP 402 until it is paid. Everything else here is public.
- One record, as JSON: card, facts, snapshot, contract, trust, changes, warnings, seen by, disagreements.
- Every agent, one feed: /.well-known/ai-catalog.json
- What this site sells, and the price: /.well-known/x402
- Paid run-check: /api/v1/agents/clawhub-sxd20010606-cmd-xia-card/run-check