前端调用AionClaw后端接口需启用本地HTTP API网关（默认端口8080），通过Bearer Token认证访问Swagger文档列出的接口，如/skills/run，并注意跨域配置与参数严格匹配。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在前端调用 AionClaw 已经内置或用户自定义的后端接口（如本地 RPA 任务、技能执行、定时任务触发等），必须绕过传统 Web 服务代理，直接对接其本地 HTTP API 网关。AionClaw 默认在本地启动一个轻量级 RESTful 服务（默认端口 【8080】），所有技能、自动化流程、手机控制指令都通过该端口暴露标准接口，前端只需发起符合规范的 HTTP 请求即可驱动真实电脑操作。
确认 AionClaw 本地 API 服务已启用
打开 AionClaw 客户端 → 左侧导航栏点击「安全保护」→ 查看右侧「本地 API 服务」开关状态。若为灰色关闭状态，点击开启并等待状态变为绿色「运行中」；【未开启此服务时，所有前端 HTTP 调用均会返回 Connection Refused】。该服务默认绑定 127.0.0.1，不对外网开放，仅限本机浏览器或 Electron/WebView 前端调用。
获取可用接口列表与认证方式
在浏览器地址栏输入 http://127.0.0.1:8080/api/v1/docs ，可直接打开 Swagger 文档页，列出全部已注册接口：/skills/run、/rpa/trigger、/task/schedule、/wechat/send 等。每个接口右上角标注「Auth」标签，表示需携带 Bearer Token 认证；Token 并非用户登录密码，而是客户端「个人中心」→「API 访问凭证」页生成的长期有效密钥，复制后用于请求头 Authorization 字段。
前端调用示例：触发一个预设技能
方法一：使用 fetch 发起 POST 请求
立即学习“前端免费学习笔记（深入）”；
在前端 JavaScript 中执行：
fetch('http://127.0.0.1:8080/api/v1/skills/run', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer sk-aion-xxxxxxxxxxxx'
},
body: JSON.stringify({
"skill_id": "excel_auto_fill",
"params": {"file_path": "/Users/me/Documents/data.xlsx"}
})
});
注意：skill_id 必须与「技能市场」→「已安装」列表中显示的 ID 完全一致，大小写敏感；参数字段名必须与该技能文档定义严格匹配，否则返回 400 错误且不提示具体缺失项。
方法二：用 HTML 表单 + FormData 提交（适用于无 JS 环境）
创建一个 form 标签，action 指向 http://127.0.0.1:8080/api/v1/skills/run，method 为 POST，添加隐藏 input 设置 Authorization 头值（需后端配合支持 form-data 解析，AionClaw v2.3.1+ 已内置支持）。
跨域问题处理路径
第一步：确认浏览器是否为 Chrome / Edge / Safari 最新版；
第二步：启动浏览器时添加启动参数 --user-data-dir=/tmp/aion-test --unsafely-treat-insecure-origin-as-secure="http://127.0.0.1:8080" --user-agent="AionClaw-Frontend/1.0"；
第三步：在前端代码中显式设置 mode: 'no-cors' 仅适用于简单 GET 请求，POST 必须走第一种 fetch 方式并确保服务端已注入 CORS 头——AionClaw 默认已在 8080 服务响应头中写入 Access-Control-Allow-Origin: http://127.0.0.1:3000（开发服务器常用端口），若你用其他端口（如 5173），需进入客户端「设置」→「开发者选项」→ 手动修改 cors_origin 配置项并重启服务。
