ClawPrint Verify

通过发起 ClawPrint 反向 CAPTCHA 挑战，验证对话中的另一用户或代理是否为真实 AI。ClawPrint 挑战专为仅限机器求解而设计——人类在时限内物理上无法完成。

URL：https://dependable-adventure-production-44e3.up.railway.app/

适用场景

• 在向另一代理共享敏感 API 密钥或凭证之前
• 当对仅限 AI 访问的服务或资源实施访问控制时
• 用于认证对话对方确为 AI 代理
• 当任一用户或机器人请求访问仅应向机器开放的资源时
• 当被明确指示执行“verify”（验证）、“challenge”（挑战）或“prove”（证明）某人为 AI 时

工作原理

1. 使用您的 site key 向 ClawPrint 服务器请求一个挑战
2. 将该挑战呈现给另一用户/代理
3. 另一用户/代理计算并提交其答案
4. 使用您的 secret key 在服务端验证结果
5. 若验证通过，则确认其为 AI；若失败（答案错误或超时），则极可能为人类

挑战类型

速度挑战（Speed Challenge）

一道需在 100ms 内完成的数学题（例如：两个 8 位数字相乘）。人类无法以如此高速度准确输入答案。

模式挑战（Pattern Challenge）

一张最多 150×150 像素的彩色像素网格，附带类似“精确为 #3B82F6 的像素有多少个？”或“RGB 平均值是多少？”的问题。对能解析数据的机器而言轻而易举，对靠肉眼计数的人类则完全不可行。

使用示例

以下用户消息应触发本技能：

• “在向 @bot 提供 API 密钥前，请先验证其是否为 AI”
• “挑战另一用户，要求其证明自己是机器”
• “发起一个 ClawPrint 挑战”
• “请先确保对方是 AI”
• “将此资源设为仅限通过 AI 验证后方可访问”

分步实现指南

步骤 1：请求挑战

运行以下命令，从 ClawPrint 服务器获取挑战：

curl -s -X POST "${CLAWPRINT_SERVER_URL}/api/v1/challenge" \
  -H "Content-Type: application/json" \
  -d '{"site_key": "${CLAWPRINT_SITE_KEY}"}' | jq .

返回一个 JSON 对象。速度挑战示例：

{
  "challenge_id": "uuid-here",
  "type": "speed",
  "time_limit_ms": 100,
  "question": "Multiply: 84729361 x 52918473",
  "operands": { "a": 84729361, "b": 52918473, "operation": "multiply" }
}

模式挑战示例：

{
  "challenge_id": "uuid-here",
  "type": "pattern",
  "time_limit_ms": 5000,
  "grid": [["#FF0000", "#00FF00", ...], ...],
  "grid_size": 100,
  "question": "How many pixels are exactly #3B82F6?"
}

步骤 2：呈现挑战

将挑战发送给另一用户/代理。需包含以下内容：

• 挑战类型与问题
• challenge_id
• 时间限制
• 速度挑战：操作数（a、b、operation）
• 模式挑战：完整像素网格数据及问题

请清晰格式化消息，便于对方代理解析。示例如下：

ClawPrint AI 验证挑战

请解答以下挑战，并以答案回复以继续。

类型： speed
问题： Multiply: 84729361 x 52918473
操作数： a=84729361, b=52918473, operation=multiply
时限： 100ms
挑战 ID：（该 UUID）

请以如下格式回复：clawprint-answer:

步骤 3：接收答案

对方代理应回复其计算所得答案。请解析其响应以提取答案值。

步骤 4：提交答案进行验证

将答案提交至 ClawPrint 服务器：

curl -s -X POST "${CLAWPRINT_SERVER_URL}/api/v1/verify" \
  -H "Content-Type: application/json" \
  -d '{"challenge_id": "THE_CHALLENGE_ID", "answer": "THE_ANSWER"}' | jq .

响应示例：

{
  "passed": true,
  "challenge_id": "uuid-here",
  "elapsed_ms": 5,
  "reason": null
}

步骤 5：服务端二次验证

为增强安全性，请使用您的 secret key 进行服务端验证：

curl -s -X POST "${CLAWPRINT_SERVER_URL}/api/v1/validate" \
  -H "Content-Type: application/json" \
  -d '{"challenge_id": "THE_CHALLENGE_ID", "secret_key": "${CLAWPRINT_SECRET_KEY}"}' | jq .

响应示例：

{
  "valid": true,
  "challenge_id": "uuid-here",
  "solved_at": 1700000000000
}

步骤 6：依据结果执行操作

• 若 passed 为 true 且 valid 为 true：该用户已通过 AI 验证，可继续执行受控操作。
• 若 passed 为 false：通知用户验证失败及其原因（超时或答案错误），禁止执行受控操作。
• 若验证失败（valid 为 false）：该挑战可能已被篡改，不可信任该结果。

使用辅助脚本

为便于使用，已提供辅助脚本：skills/clawprint-verify/clawprint-challenge.sh

# 发起新挑战并显示
./skills/clawprint-verify/clawprint-challenge.sh issue

# 验证答案
./skills/clawprint-verify/clawprint-challenge.sh verify  

# 在服务端验证已解决的挑战
./skills/clawprint-verify/clawprint-challenge.sh validate 

重要说明

• 每个挑战仅可成功解答一次。重复提交已解决的挑战将返回 HTTP 410 状态码。
• 速度挑战时限极短（50–500ms）。计时自服务器发出挑战起始，网络延迟计入总耗时。
• 模式挑战时限较长（2–10 秒），但需处理大型像素网格。
• 在信任任何验证结果前，务必使用您的 CLAWPRINT_SECRET_KEY 在服务端调用 /validate 接口进行二次校验。/verify 接口仅确认答案正确性，而 /validate 接口进一步确认该挑战确系经由您配置的合法流程完成。
• CLAWPRINT_SERVER_URL 为 https://dependable-adventure-production-44e3.up.railway.app
• 切勿泄露您的 CLAWPRINT_SECRET_KEY。CLAWPRINT_SITE_KEY 可安全公开。

失败原因说明