身份管理

技能简介

身份管理（agent-identity-kit）是一款可移植的 AI 代理身份系统。支持创建、验证和发布 agent.json 身份卡，符合 Agent Card v1 规范，可在不同平台和系统间共享代理身份信息。

业务背景

身份管理帮助开发团队为AI代理建立标准化"数字名片"。通过生成符合行业规范的agent.json身份卡，解决代理在多平台协作时的身份识别问题——其他系统能自动读取代理的能力、协议和信任等级，无需反复人工对接。适用于构建多代理协作网络或对外发布可信赖的AI服务。

落地案例：某技术团队开发了数据分析代理，需要让第三方BI工具安全调用。使用本工具交互式填写代理名称、能力标签（如SQL生成、图表渲染）、支持协议等信息，自动生成agent.json身份卡并验证合规性。随后将身份卡注册至forAgents.dev目录，BI工具即可自动发现该代理的功能边界和对接方式，双方免去了繁琐的技术文档往来。

能做什么

• 通过交互式设置生成 agent.json 身份卡
• 根据 Agent Card v1 Schema 验证身份卡
• 提供 JSON Schema 用于编辑器集成和 CI 流水线
• 支持多代理团队名册管理
• 可注册到 forAgents.dev 全球代理目录

使用说明

安装 Skill：

通过 ClawHub 安装：

clawhub install agent-identity-kit

生成身份卡：

./scripts/init.sh

脚本会交互式提示输入：名称、handle、描述、所有者、能力等，输出有效的 agent.json。

验证身份卡：

./scripts/validate.sh path/to/agent.json

使用 schema/agent.schema.json 验证，需要 ajv-cli（缺失时自动安装）。

身份卡字段说明：

• version：规范版本（”1.0″）
• agent.name：显示名称
• agent.handle：Fediverse 风格句柄（@name@domain）
• agent.description：代理功能描述
• owner.name：责任人
• capabilities：能力标签列表
• protocols：支持的协议（MCP、A2A、HTTP）
• trust.level：信任级别（new、active、established、verified）
• endpoints.card：身份卡规范 URL
• links：网站、仓库、社交链接

托管身份卡：

建议将 agent.json 托管在以下地址：

https://yourdomain.com/.well-known/agent.json

多代理：https://yourdomain.com/.well-known/agents.json

注册到 forAgents.dev：

在 foragents.dev 注册代理可加入全球代理目录，验证通过的代理会获得徽章。

输入与输出

见下方输入与输出表格。

风险提示

• 身份卡包含代理描述和能力信息，注意隐私保护
• 验证需要 ajv-cli，首次使用可能自动安装
• 信任级别反映代理成熟度，新代理建议从 new 开始
• 托管 URL 应保持稳定，频繁变更会影响其他系统引用

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/ryancampbell/agent-identity-kit/SKILL.md

来源类型：GitHub