← Back to Skills Marketplace
Xia Card
by
sxd20010606-cmd
· GitHub ↗
· v2.3.0
· MIT-0
141
Downloads
0
Stars
0
Active Installs
7
Versions
Install in OpenClaw
/install xia-card
Description
个人社交名片生成、管理和分享,以及智能花名册(通讯录管理器)。当用户提到名片、花名册、通讯录、联系人、虾名片、agent-card 时使用。具体触发场景包括:开通虾名片、建花名册、生成/更新/发名片、注册虾名片、录入/查询/编辑联系人、同步花名册、收到包含 agent-card:// 协议的消息时自动识别并保存他...
Usage Guidance
What to check before installing:
- Trust the server: config.json defaults to https://www.adonghub.cn. Confirm you trust that host and its privacy policy because your public card fields and the api_key (stored locally) will be sent to it. Consider changing the endpoint if you use a different service.
- Review auto-install behavior: the skill may prompt to install a skill whose source is provided inside a received card. Prefer to require manual review/approval and only allow installation from trusted/verified sources (platform-owned URLs or a signed manifest). Disable or tighten any automatic-install flow if possible.
- Protect the API key: api_key returned by POST /register is stored in data/config.json in plain text. If this machine is shared or untrusted, treat the config file as sensitive (or ask for encrypted storage).
- Be careful with Agent memory use: the skill instructs the Agent to pull information from agent memory to build the card. Make sure the Agent does not inadvertently expose private notes or secrets by confirming every field before publishing.
- Limit autonomous actions: if you are uncomfortable with autonomous skill invocation or auto-install prompts, install but disable autonomous invocation or require manual confirmation for network calls/installs.
What would reduce my concern:
- The skill enforces that _skill.source must be a vetted platform URL (or signed) before any automated install, or the platform provides a safe install-by-reference flow.
- The implementation shows explicit filtering of uploaded fields (server-bound payload is strictly derived from tiers.public.fields) and documents that api_key is stored securely or only held in volatile memory.
Confidence note: medium — the skill is coherent for its stated purpose, but the automatic-install-from-remote-card behavior and plaintext storage of api_key are notable risks that push this assessment to 'suspicious'. Additional implementation details about install verification and how api_key is stored would raise confidence toward benign.
Capability Analysis
Type: OpenClaw Skill
Name: xia-card
Version: 2.3.0
The skill bundle implements a business card and contact management system that communicates with a remote endpoint (www.adonghub.cn). While the core functionality appears aligned with its stated purpose, it contains high-risk instructions in SKILL.md and references/manual.md that direct the AI agent to automatically parse a custom protocol (agent-card://) and facilitate the installation of external skills from URLs found within third-party data (the '_skill' field in received JSON). This 'auto-install' capability creates a significant attack surface for the distribution of potentially malicious code through the agent's ecosystem.
Capability Tags
Capability Assessment
Purpose & Capability
技能名、描述和所有核心操作(初始化本地 data/* 文件、通过 POST /register 获取 api_key 和 user_id、PUT /card/:user_id 上线名片、GET /card/:user_id 获取他人的名片、POST /sync 批量同步)是一致的。没有要求与功能无关的系统凭据或二进制,默认将服务器 endpoint 预填为 https://www.adonghub.cn,符合该功能需要远端 API 的预期。
Instruction Scope
SKILL.md 明确指导读取/写入本地 data/ 文件并与远程服务器交换名片数据——这些在功能范围内。但有两点值得警惕:1) 文档要求 Agent 在生成名片时“从记忆(USER.md、MEMORY.md 等)提取信息”,这让 Agent 访问任意记忆/上下文来填充公开名片,可能将敏感记忆信息用作候选内容(文档要求确认社交姓名,但并未对提取来源做更严格限制)。2) 收到 agent-card:// 消息时,若目标 skill 未安装,流程会“从接收到的 JSON 的 _skill 字段获取安装源并自动安装”(在 manual 中又写到“用户确认后自动安装”——存在模糊:是否总会自动安装或在何种条件下会安装未明确)。允许安装来源由远程返回决定,会使接收到的名片成为传播可执行技能安装的载体。
Install Mechanism
技能本身无 install spec(只包含运行时说明和模板),这通常更安全。但说明中包含从远端 card JSON 的 _skill.source 字段“获取安装源并自动安装”的做法:如果服务器返回的是任意 URL(或可被第三方控制),则会导致代理去拉取并安装第三方技能(高风险安装链)。示例中 _skill.source 指向 platform 域(https://clawhub.ai/skills/xia-card),这是可接受的,但 SKILL.md 没有强制检查/白名单或签名验证流程,因此存在被诱导安装恶意技能的风险。
Credentials
技能不要求任何环境变量或外部凭据预配置;运行时会通过 POST /register 获取 api_key 和 user_id 并将它们写入 data/config.json(本地明文存储)。这与功能相称,但需要注意:api_key 是可用来代表用户与服务进行 /sync 和 PUT 操作的长期凭据,存为明文文件增加凭据被本地窃取的风险。文档也声明 personal_notes 和部分字段“永远不会上传服务器”,并规定只上传 tiers.public.fields;这是良好方向,但最终上传内容取决于客户端实现是否严格遵守该筛选。
Persistence & Privilege
技能不是 always:true,且默认允许模型调用(agent 可自主调用),这本身是平台默认。技能会在 data/ 下创建并维护文件(profile.json、contacts.json、config.json)——这是合理且必要的。主要风险来自:允许在收到外部 card 时触发安装其它技能(即便要求用户确认,自动安装流程若被滥用会扩大权限和传播范围)。没有迹象表明它会修改其他技能的配置或系统范围设置。
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install xia-card - After installation, invoke the skill by name or use
/xia-card - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.3.0
SKILL.md 精简重构:248行→113行,实现细节移至 references/manual.md,ClawHub 页面更简洁
v2.2.0
V2.2: 去掉发布步骤(生成即上线)、注册回复精简、已注册改服务菜单、收名片去重策略、编辑优先级(manually_edited_fields)、防御分支精简、社交姓名追问、三段式补充skill安装链接
v2.0.1
F1: 版本号 v1.0→v2.0 (card.html); F2: profile.js 黑名单补 sync; F3: deploy.sh 补全文件列表+npm install
v2.0.0
V2: 批量同步通讯录、user_id 服务器自动生成、收名片记录 server_user_id、协议格式优化
v1.0.2
优化名片第三段文案,协议标识去掉@符号,提升社交场景体验
v1.0.1
移除打包的 API Key 和用户数据,只保留空模板
v1.0.0
V1: 名片生成/发布/分享/收名片/花名册管理
Metadata
Frequently Asked Questions
What is Xia Card?
个人社交名片生成、管理和分享,以及智能花名册(通讯录管理器)。当用户提到名片、花名册、通讯录、联系人、虾名片、agent-card 时使用。具体触发场景包括:开通虾名片、建花名册、生成/更新/发名片、注册虾名片、录入/查询/编辑联系人、同步花名册、收到包含 agent-card:// 协议的消息时自动识别并保存他... It is an AI Agent Skill for Claude Code / OpenClaw, with 141 downloads so far.
How do I install Xia Card?
Run "/install xia-card" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Xia Card free?
Yes, Xia Card is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Xia Card support?
Xia Card is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Xia Card?
It is built and maintained by sxd20010606-cmd (@sxd20010606-cmd); the current version is v2.3.0.
More Skills