📦 Clawprint-skill — Clawprint — AI代理LLC创建

为AI代理注册LLC。每个代理获得一个带有EIN和银行账户的合法商业实体。

HTTP API — 先发现产品（使用脚本）

认证模型

• GET /api/products — 无凭证（发现）。
• POST /api/users — 无凭证。JSON响应包含 public_key 和 secret_key：以 public_ 和 secret_ 为前缀的不透明字符串。
• 持久化两者 — 将它们添加到 .env 作为 CLAWPRINT_PUBLIC_KEY 和 CLAWPRINT_SECRET_KEY（参见 .env.example）。像对待密码一样对待密钥；不要提交真实值。
• 认证路由（如 POST /api/businesses）— 在每个请求上发送两个头：X-Public-Key 和 X-Secret-Key。CLI读取两个环境变量并在启用认证时（默认）设置这些头。仅对发现和用户注册使用 --no-auth；对一次性覆盖使用 --public-key / --secret-key。如果任一头缺失或该对与注册用户不匹配，服务器返回 401。

发现 — 始终首先使用CLI调用 GET /api/products（默认在不传递标志时）：

• 在 .env 中设置基础URL（参见 .env.example）：CLAWPRINT_SITE_URL（部署源，如Convex）或 CLAWPRINT_API_URL（默认 https://clawprintai.com/api）。
• 从 clawprint-skill 目录运行，不带参数 — 这执行 GET /api/products 并将产品列表（JSON数组）打印到stdout：

node scripts/clawprint.js

等效：npm run clawprint（运行 scripts/clawprint.js）。此调用不发送认证头。

• 解析JSON数组 — 每个条目包含 id、method、path、description 和 agent_integration（auth、headers、body、steps）。
• 使用相同脚本发出后续调用 — --product （再次获取 GET /api/products 以解析method/path）或显式的 --method / --path，与产品列表匹配。注册后通过 POST /api/users 设置 CLAWPRINT_PUBLIC_KEY 和 CLAWPRINT_SECRET_KEY 到 .env 以便受保护调用发送两个密钥头；当您打算覆盖该行为时使用 --no-auth 或显式的 --public-key / --secret-key。

如果没有此仓库，您可以使用curl访问相同URL（无认证）：

curl -sS "{origin}/api/products" -H "Accept: application/json"

快速开始

CLI：先产品，后任何路由

# 首次调用（始终）：GET /api/products — 产品列表到stdout
node scripts/clawprint.js
# 注册用户（无认证）。响应JSON包含"public_key"和"secret_key" — 添加到.env：
# CLAWPRINT_PUBLIC_KEY=public_…
# CLAWPRINT_SECRET_KEY=secret_…
node scripts/clawprint.js --product create_user --no-auth \
  --body '{"email":"you@example.com","display_name":"My Agent"}'
# 或者：显式路径
node scripts/clawprint.js --method POST --path /api/users --no-auth \
  --body '{"email":"you@example.com","display_name":"My Agent"}'

创建企业

在 .env 中设置 CLAWPRINT_PUBLIC_KEY 和 CLAWPRINT_SECRET_KEY（来自注册响应），调用 POST /api/businesses（或产品列表中匹配的产品ID）不带 --no-auth 以便CLI发送 X-Public-Key 和 X-Secret-Key。使用与该产品 agent_integration 匹配的JSON --body（例如，根据实时产品目录的 requested_business_name）。担保人收到一封电子邮件以验证身份（一次性KYC）。

检查状态

从相同脚本，使用 GET /businesses/:id/status（或产品列表中匹配的产品ID）：--method GET、--path 和可选的 --query。如果该产品的 agent_integration 需要认证，保持 CLAWPRINT_PUBLIC_KEY 和 CLAWPRINT_SECRET_KEY 在 .env 中且不传递 --no-auth。

工作原理

您获得的内容

每个代理企业都是一个 怀俄明州DAO LLC，包含：

• 在州注册的法律商业实体
• 来自IRS的EIN（税务ID）
• FDIC保险的银行账户（路由账号和账号）

法律模型

• 代理 — 运营企业
• 担保人 — 法人所有者，提供KYC，保持监督
• 运营协议 — 将权力委托给代理

时间线

• 通过API提交企业详情（CLI：node scripts/clawprint.js 使用businesses产品/路径）
• 担保人通过电子邮件验证身份（KYC）
• Clawprint向怀俄明州提交LLC申请
• IRS发放EIN（1-5个工作日）
• 银行账户开立（2-5个工作日）
• 企业激活（总计3-10天）

要求

对于担保人：

• 美国公民或居民
• 用于IRS报告的有效SSN
• 用于KYC验证的电子邮件

对于代理：

• 有效的企业名称和目的
• 担保人电子邮件

费用

注册：约$150（怀俄明州提交+注册代理+杂费） 持续：约$10/月（注册代理）

担保人仪表板

KYC后，担保人可以：

• 查看所有担保的企业
• 实时查看企业状态
• 管理银行账户访问

限制

• 仅美国（仅怀俄明州LLC）
• 3-10天时间线（无法加急）
• 需要担保人（担保人承担法律责任）

完整API参考，请参阅REFERENCE.md