Robot Id Card

Robot ID Card 是一个 Bot 身份认证标准及实现：用 Ed25519 签名签发 ric_ 身份证书，提供基于 Fastify 与 SQLite 的公开注册中心、JWKS 公钥目录与 nonce 防重放，附带 CLI、Chrome 扩展和 Express/Fastify 网站验证 SDK，支持 0-5 级权限、每日签到信誉与公开审计日志。

cosmofang

热度 46.09

最近更新 2026-05-11 17:41:45

分类：安全依赖：代码执行 / 读写文件 / 第三方 API应用场景：API 集成 / 自动化脚本 / 工作流 / DevOps ...

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add robot-id-card

Metadata

name: robot-id-card
description: Bot 身份认证标准 — 为 AI Agent 和机器人签发加密身份证书，让网站信任你的 bot。遵循 RFC 9421 HTTP Message Signatures 国际标准，与 Cloudflare Web Bot Auth 生态兼容。内置 Ed25519 签名注册中心、JWKS 公钥目录、nonce 防重放、CLI 工具、浏览器扩展和网站 SDK，支持分级权限控制（0-5级）、每日签到信誉积累、公开审计日志。 Universal identity standard for AI bots — RFC 9421 aligned, Web Bot Auth compatible, cryptographically signed certificates, public audit registry, permission-based access control.
keywords: ["robot-id-card","bot-identity","bot-passport","bot-certificate","ai-agent","ed25519","cryptographic-identity","bot-verification","web-security","browser-extension","sdk","registry","bot-accountability","permission-system","audit-trail","bot-grade","ai-safety","机器人身份","bot认证","AI安全"]
requirements: {"node":">=18","binaries":[{"name":"node","required":true,"description":"Node.js runtime >= 18"},{"name":"npm","required":true,"description":"npm package manager"}]}
metadata: {"openclaw":{"homepage":"https://github.com/Cosmofang/robot-id-card","author":"Cosmofang","runtime":{"node":">=18"},"env":[]}}

Robot ID Card — Bot 身份认证标准

Give your bot a passport. Let websites trust it.

Purpose & Capability

Robot ID Card (RIC) 是一个 Bot 身份认证标准，解决互联网无法区分好 bot 和坏 bot 的问题。

核心能力：

能力	说明
加密身份证书	Ed25519 签名，每个 bot 获得唯一 `ric_` ID
公开注册中心	SQLite 持久化，REST API，Fastify 驱动
分级权限系统	Level 0-5，网站根据 bot 等级授予不同权限
每日签到信誉	连续 3 天 `ric claim` 即可从 unknown 升级到 healthy
自动降级	3 次举报 → 自动标记 dangerous → Level 0 封锁
CLI 工具	`ric keygen / register / claim / status / verify / report`
浏览器扩展	Manifest V3，自动注入 RIC 请求头
网站 SDK	Express + Fastify 中间件，一行代码集成

能力边界（不做的事）：

不替代 OAuth/JWT 用户认证（RIC 是 bot 身份，不是用户身份）
不提供 WAF 或 DDoS 防护
不做内容审核或行为监控

Instruction Scope

在 scope 内：

"帮我注册一个 bot 身份" / "给我的 bot 签发证书"
"验证这个 bot 是否可信" / "查看 bot 等级"
"在我的网站集成 RIC 验证"
"启动本地 registry 服务器"
"我的 bot 怎么从 unknown 升到 healthy"

不在 scope 内：

用户账号认证（那是 OAuth/Passport.js 的工作）
反爬虫策略设计（RIC 是身份系统，不是防火墙）
区块链/去中心化身份（v1.0 路线图功能，当前未实现）

Credentials

本 skill 无需任何 API token 或密钥即可运行。

操作	凭证	说明
启动 registry	无	`npm run dev:registry` 直接启动
生成密钥对	无	`ric keygen` 在本地生成 Ed25519 密钥
注册 bot	Bot 私钥	用户自己生成的 `*.key.json`，存在本地
部署到 Render	`RIC_ADMIN_KEY`	可选，Render 自动生成，用于管理员操作

不做的事：

不读取、传输或记录任何第三方 API 凭证
不访问 GitHub/clawHub token
Bot 私钥文件仅存在用户本地，不上传到 registry

Persistence & Privilege

路径	内容	触发条件
`packages/registry/data/registry.db`	SQLite 数据库（bot 记录、审计日志、签到）	registry 启动时自动创建
`*.key.json`（用户指定路径）	Ed25519 密钥对	`ric keygen` 时生成
`dist/`（各包）	TypeScript 编译输出	`npm run build`

不写入的路径：

不修改系统配置或 shell 环境
不创建 cron 任务
不写入 node_modules/ 以外的全局路径

权限级别：

以当前用户身份运行，不需要 sudo
registry 监听 localhost:3000（可配置 PORT 环境变量）
完整卸载：删除项目目录即可

Install Mechanism

标准安装（从 clawHub）

clawhub install robot-id-card

从源码安装

git clone https://github.com/Cosmofang/robot-id-card.git
cd robot-id-card
npm install
npm run build

验证安装

npm run dev:registry
# 应输出: RIC Registry running on http://localhost:3000

# 另一个终端
curl http://localhost:3000/health
# 应返回: {"status":"ok","version":"0.2.0"}

npm 包安装（发布后可用）

npm install -g @robot-id-card/cli    # CLI 工具
npm install @robot-id-card/sdk       # 网站 SDK

Packages

包名	说明	版本
`@robot-id-card/registry`	注册中心服务器（Fastify + SQLite）	0.2.0
`@robot-id-card/cli`	开发者 CLI 工具	0.2.0
`@robot-id-card/sdk`	网站集成 SDK（Express + Fastify 中间件）	0.2.0
`@robot-id-card/extension`	Chrome 浏览器扩展（Manifest V3）	0.2.0

Version: 0.4.0 · Created: 2026-03-24 · Updated: 2026-04-17 · RFC 9421 aligned