aionclaw执行数据库技能失败时，须通过开发者工具捕获原始http请求与响应，依据状态码、error/code字段及network行为（如pending/failed）精准区分网络中断、权限不足、sql错误或服务未响应；关键确认host不能填localhost而须用databaseclaw实际内网ip。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当AionClaw执行数据库类技能（如DatabaseClaw集成任务）失败时，仅看前端报错“操作失败”无法定位是网络中断、权限不足、SQL语法错误，还是目标库根本未响应。必须捕获接口原始返回体与状态码，才能区分是DBA侧配置问题，还是AionClaw调用层参数拼接错误。
确认失败请求是否已发出
打开AionUi开发者工具（Ctrl+Shift+I → Network标签），在触发数据库操作后立即筛选fetch或xhr请求，找到以/api/skill/database或类似路径开头的条目。若该请求未出现在列表中，说明失败发生在技能调度前——检查AionClaw日志中是否有Skill not found或No matching provider提示。
若请求存在但状态为(failed)或pending，说明网络层已断开，跳转至下一节排查网关连通性。
抓取并解析真实HTTP响应
点击上一步捕获到的失败请求 → 查看Headers → 复制Request URL和Response Headers中的status字段值（如502 Bad Gateway或401 Unauthorized）。
切换到Response标签页：若显示Failed to load response data，说明服务端未返回任何body，大概率是DatabaseClaw实例未启动或aionCore与DatabaseClaw之间TCP连接被防火墙拦截；若显示JSON内容，重点查看error、message、code三个字段——【DatabaseClaw返回的code字段值（如DB_CONN_TIMEOUT、SQL_SYNTAX_ERROR）比HTTP状态码更能精准定位故障类型】。
注意：某些DatabaseClaw版本在L3/L4级操作被拒绝时，会返回HTTP 200但body中success: false且reason字段注明“Operation blocked by safety policy”，这不是接口失败，而是安全策略生效。
验证aionCore与DatabaseClaw连通性
第一步：在AionClaw所在服务器执行
curl -v http://localhost:18789/api/system/health
确认aionCore网关本身运行正常（应返回HTTP 200 + JSON含status: "ok"）。
第二步：检查aionCore配置中DatabaseClaw服务地址是否正确。编辑~/.aionclaw/config.yaml，定位databaseclaw:段：
host: 172.16.10.23
port: 8080
timeout: 30
【host不能填localhost，必须填DatabaseClaw实例在VPC内的实际内网IP；填localhost会导致aionCore尝试连接本机而非DatabaseClaw所在节点】
第三步：从aionCore服务器直连DatabaseClaw服务端口
telnet 172.16.10.23 8080
若连接超时，检查DatabaseClaw实例是否运行、VPC安全组是否放行8080端口、两台服务器是否在同一子网。
