AionClaw配套网站必须直连本地http://127.0.0.1:8080网关、禁用SSR、隔离静态资源,优先选Node.js/Python后端与Vue前端组合,按管理后台、多租户市场或离线文档站三类场景选用对应方案。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

为AionClaw开发配套网站时,需匹配其本地智能体运行特性、低门槛部署逻辑与Hermes Agent双引擎协同机制,不能套用通用Web框架模板——否则会导致模型通道绑定失败、技能调用超时、Webhook触发丢失等不可逆中断。
确认网站核心用途与数据流向
先明确这个网站是面向终端用户(如技能市场展示页)、内部运维人员(如Key管理后台),还是开发者(如插件SDK文档站)。AionClaw所有对外接口默认走本地http://127.0.0.1:8080网关,且仅接受JSON-RPC 2.0格式请求;若网站需实时调用AI执行能力,必须绕过CORS限制或启用反向代理,否则前端发起的fetch会直接被浏览器拦截。
这一步跳过将导致后续所有API对接全部失效,且错误提示极不明确——浏览器控制台只显示“net::ERR_CONNECTION_REFUSED”,实际是网关未暴露到公网或未启用跨域白名单。
技术栈选型三原则
原则一:服务端必须能直连AionClaw本地网关。Node.js(Express/Fastify)或Python(Flask/FastAPI)可直接axios.post('http://127.0.0.1:8080', {...})调用,而PHP、Java需额外配置HTTP客户端超时与重试策略,否则在Hermes Agent执行长任务(如批量生成600条文案)时极易触发504。
原则二:前端禁止使用SSR框架(如Next.js、Nuxt)默认服务端渲染模式。AionClaw不提供服务端Token校验接口,所有鉴权必须由前端携带X-Auth-Token头转发至本地网关,SSR首次渲染时无法注入该Header,会导致首屏空白且无报错。
原则三:静态资源必须与AionClaw安装目录隔离。官方安装包默认将skills/、models/、logs/写入%APPDATA%\AionClaw(Windows)或~/Library/Application Support/AionClaw(macOS),网站若把dist/也放同一级路径,升级时会被一键安装脚本误删。
推荐组合方案
方法一:轻量级管理后台(适合3人以内团队)
① 前端用纯HTML + Vue 3 CDN版(<script src="https://unpkg.com/vue@3/dist/vue.global.js"></script>),所有交互通过fetch直连http://127.0.0.1:8080/v1/skills/list;
② 后端免部署,用AionClaw内置的webhook-server模块开启--enable-webhook参数,网站提交表单后由它自动转成技能调用指令;
③ 静态文件直接放在C:\AionClaw-Web\(Windows)或~/AionClaw-Web/(macOS),启动网站时运行python -m http.server 8000即可,【务必关闭AionClaw自带的HTTP服务端口冲突】。
方法二:多租户技能市场(适合SaaS服务商)
用FastAPI写后端,集成TaoToken统一Key网关作为中继层,所有对AionClaw的调用都经由https://api.taotoken.dev/v1/proxy转发,避免暴露本地IP;前端用Vite构建,通过import.meta.env.VITE_TAOTOKEN_MODEL_ID动态切换底层模型,这样客户换用LinClaw或PowerClaw时,只需改一个环境变量,无需重写接口逻辑。
方法三:离线文档站(适合无网络环境部署)
用Docusaurus生成静态站,所有API示例代码块内嵌curl -X POST http://127.0.0.1:8080/v1/task/run -d '{"skill":"send_email","to":"user@demo.com"}',用户复制即用;打包后整个build/文件夹拖进AionClaw安装目录同级的docs/子目录,通过http://127.0.0.1:8080/docs/index.html访问——这是唯一不需要额外起服务的方案。











