CAPTCHAS + OpenClaw

在通过OpenResponses工具或OpenClaw插件工具将CAPTCHAS与OpenClaw集成时，使用此技能。

配置

设置环境变量：

• - CAPTCHASENDPOINT = https://agent.captchas.co
• CAPTCHASAPI_KEY =

请求头：

• - x-api-key：必需（使用CAPTCHASAPIKEY）。
• x-domain：可选；若提供则进行验证。

注意：

• - site_key为可选；若省略，则从API密钥或账户默认值中解析。
• 避免在signals中发送个人身份信息（PII）。

OpenResponses工具架构（OpenClaw网关）

在调用网关/v1/responses端点时，使用OpenClaw的tools数组格式。

json
{
tools: [
{
type: function,
function: {
name: captchasagentverify,
description: 运行CAPTCHAS代理验证并返回决策（允许|拒绝|挑战）。,
parameters: {
type: object,
properties: {
site_key: {type: string},
action: {type: string},
signals: {type: object, additionalProperties: true},
capabilities: {
oneOf: [
{type: object, additionalProperties: true},
{type: array, items: {type: string}}
]
},
verificationmode: {type: string, enum: [backendlinked, agent_only]},
challengesource: {type: string, enum: [bank, aigenerated]},
input_type: {type: string, enum: [choice, image, behavioral]},
media_url: {type: string},
media_type: {type: string}
},
required: [],
additionalProperties: false
}
}
},
{
type: function,
function: {
name: captchasagentchallenge_complete,
description: 完成挑战并在通过时生成验证令牌。,
parameters: {
type: object,
properties: {
challenge_id: {type: string},
site_key: {type: string},
answer: {type: string}
},
required: [challenge_id, answer],
additionalProperties: false
}
}
},
{
type: function,
function: {
name: captchasagenttoken_verify,
description: 在执行敏感操作前验证不透明的CAPTCHAS令牌。,
parameters: {
type: object,
properties: {
token: {type: string},
site_key: {type: string},
domain: {type: string}
},
required: [token],
additionalProperties: false
}
}
}
]
}

OpenClaw插件工具注册

使用api.registerTool(...)注册工具，参数使用与上述相同的JSON Schema。

示例：

js
api.registerTool({
name: captchasagentverify,
description: 运行CAPTCHAS代理验证并返回决策（允许|拒绝|挑战）。,
parameters: {
type: object,
properties: {
site_key: { type: string },
action: { type: string },
signals: { type: object, additionalProperties: true }
},
required: [],
additionalProperties: false
},
async execute(_id, params) {
return { content: [{ type: text, text: JSON.stringify(params) }] };
}
});

参考

• - 使用/v1/agent/verify、/v1/agent/challenge/:id/complete和/v1/agent/token-verify作为标准API调用。
• 工作流程指导请参见captchas-human-verification/SKILL.md。