ClawHub

Robot Id Card

Data & APIs

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.

Audits

Pending
ClawScanReview

Agentic behavior and permission review.

Static analysisReview

Pattern checks against bundled files.

VirusTotalPending

Multi-engine malware detections and file reputation.

Install

openclaw skills install robot-id-card

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 请求头
网站 SDKExpress + 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 密钥
注册 botBot 私钥用户自己生成的 *.key.json，存在本地
部署到 RenderRIC_ADMIN_KEY可选，Render 自动生成，用于管理员操作

不做的事：

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

Persistence & Privilege

路径内容触发条件
packages/registry/data/registry.dbSQLite 数据库（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/extensionChrome 浏览器扩展（Manifest V3）0.2.0

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

More in Data & APIs