aionclaw因缺失接口schema中断时,需补全aionclaw.yaml中schema节点、用mock文件临时接管或动态注入运行时类型信息。三者须字段名大小写严格一致,且覆盖所有下游依赖字段,否则导致映射失败或keyerror。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

项目文档缺失关键接口说明或字段定义时,AionClaw会因无法解析输入/输出结构而中断执行,此时需绕过静态校验直接注入运行时上下文。
补全缺失的Schema定义
打开项目根目录下的 aionclaw.yaml 文件,在 【schema】 节点下手动添加缺失的 JSON Schema 片段。字段名必须与 API 响应体中实际键名完全一致,大小写敏感。
例如接口返回 {"user_id": 123, "status": "active"},则 schema 必须写成:user_id: {type: integer}, status: {type: string}。漏掉任一字段会导致后续数据映射失败。
用Mock响应临时接管解析流程
方法一:在 mock/ 目录新建 api_v1_users.json,内容为符合预期结构的完整示例响应。
方法二:启动 AionClaw 时添加参数 --mock=mock/api_v1_users.json,工具将跳过真实请求,直接加载该文件作为响应源。
【mock 文件必须包含所有 downstream 步骤依赖的字段,否则后续节点因取不到值而报 KeyError】
动态注入运行时类型信息
第一步:在任务脚本开头插入 Python 片段:
from aionclaw.runtime import inject_schema
第二步:调用 inject_schema("users", {"id": "integer", "name": "string"}),传入接口标识符和字段类型字典。
第三步:确保该段代码在 claw.run() 之前执行。注入后所有后续节点将按此类型推导数据流,无需修改 YAML 配置。











