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）#

bash

clawhub install robot-id-card

从源码安装#

bash

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

验证安装#

bash

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

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

npm 包安装（发布后可用）#

bash

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