AionClaw需启用Robot Framework测试能力后方可使用接口测试功能,操作包括开启“自动化测试支持”开关、导入OpenAPI 3.0规范文件、生成.robot测试用例并运行查看报告。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

确认AionClaw是否已启用Robot Framework测试能力
打开AionClaw主界面,点击左下角【系统设置】→【扩展模块】,查看“自动化测试支持”开关是否为开启状态。该模块默认关闭,【未开启时所有接口测试功能均不可用】。
若开关为灰色,需先点击右侧“启用并重启”,等待后台服务重载完成(约8秒),界面右上角弹出绿色提示“测试引擎已就绪”后方可继续。
准备待测接口的OpenAPI规范文件
在AionClaw工作区新建文件夹,命名为“test_api_spec”。
将后端提供的OpenAPI 3.0格式JSON或YAML文件(如openapi.json)直接拖入该文件夹。AionClaw会自动解析路径、请求方法、参数结构与响应示例,【不支持Swagger 2.0或Postman Collection格式,强行导入将报错中断】。
这一步操作起来很简单,直接把文件拖进去就行。
生成Robot Framework测试用例
方法一:快捷生成(推荐新手)
右键点击openapi.json文件→选择【生成RF测试套件】→勾选要覆盖的接口路径(如/v1/users、/v1/orders)→点击【确定】。
AionClaw自动生成.robot文件,存放于同级test_cases目录下,含标准Setup/Teardown、参数化关键字及断言模板。
方法二:命令行触发(适合CI集成)
打开AionClaw内置终端(Ctrl+`),执行:
aion testgen --spec ./test_api_spec/openapi.json --output ./test_cases/ --level full
--level参数可选basic(仅状态码)、full(含字段级断言)、schema(完整响应结构校验)。
运行接口测试并查看报告
第一步:确保后端服务正在运行,且AionClaw能通过本地网络访问对应地址(如http://localhost:8080)。
第二步:在AionClaw左侧导航栏切换至【测试中心】→【接口测试】→点击刚生成的test_users.robot文件。
第三步:点击右上角【运行】按钮,选择执行环境(Dev/Staging),观察控制台实时输出。测试结束后,自动在report目录生成index.html和log.html。
第四步:双击index.html即可打开可视化报告,失败用例会高亮显示请求体、响应头、实际响应体与预期断言差异。所有日志与截图均按时间戳归档,无需手动清理。














