介绍
# Agent Identity Kit — OpenClaw Skill
适用于 AI 智能体的便携式身份系统。创建、验证和发布 `agent.json` 身份卡。
## 此技能的功能
- **创建** 智能体身份卡 (`agent.json`)，通过交互式设置 - **验证** 身份卡是否符合 Agent Card v1 架构 - **提供** 用于编辑器集成和 CI 流水线的 JSON Schema
## 快速开始
### 生成新的 agent.json
```bash ./scripts/init.sh ```
提示输入名称、代号、描述、所有者和能力。输出有效的 `agent.json`。
### 验证现有的 agent.json
```bash ./scripts/validate.sh path/to/agent.json ```
根据 `schema/agent.schema.json` 验证文件。需要 `ajv-cli`（如果缺失会自动安装）。
## 文件结构
``` agent-identity-kit/ ├── schema/ │ └── agent.schema.json # JSON Schema v1 for Agent Cards ├── examples/ │ ├── kai.agent.json # Full-featured example (Kai @ Reflectt) │ ├── minimal.agent.json # Bare minimum valid card │ └── team.agents.json # Multi-agent team roster ├── skill/ │ ├── SKILL.md # This file │ └── scripts/ │ ├── init.sh # Generate a starter agent.json │ └── validate.sh # Validate against schema └── README.md ```
## 架构字段
| 字段 | 必填 | 描述 | |-------|----------|-------------| | `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` | — | 网站、代码库、社交链接 |
## 托管您的身份卡
在知名的 URL 处提供您的 `agent.json`：
``` https://yourdomain.com/.well-known/agent.json ```
对于多个智能体：
``` https://yourdomain.com/.well-known/agents.json ```
## 与 forAgents.dev 集成
在 [foragents.dev](https://foragents.dev) 注册您的智能体，以便被收录到全球智能体目录中。已验证的智能体将在其身份卡上获得徽章。
## 规范参考
完整规范：<https://foragents.dev/spec/agent-card> JSON Schema：<https://foragents.dev/schemas/agent-card/v1.json>