必须从代码结构、部署路径和技能调用三层面卡住改动边界:优先启用官方技能包;前端入口通过快捷指令面板或修改ui/custom-links.json实现;后端定制须通过isolated插件机制,限定读取路径且不影响主进程。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当你在 AionClaw 官网开发进行到一半时突然要插入新功能,又怕牵一发而动全身、改崩现有流程或拖慢上线节奏,就必须从代码结构、部署路径和技能调用三个层面卡住改动边界。
确认功能是否属于「技能层」新增
打开 AionClaw 安装目录下的 skills/ 文件夹,检查你要加的功能是否已有对应技能包(如 wechat-batch-send 或 excel-auto-fill)。【已有官方技能包的,绝不要重写逻辑,直接启用即可】。AionClaw 的技能体系是沙箱隔离的,启用新技能不会触碰主程序、不修改任何核心模块,连重启都不需要——只需在控制台点击「安装→启用」两步完成。
这一步能拦截掉 70% 的“以为要改网站”的误判。
若需定制前端交互入口
方法一:用内置「快捷指令面板」追加按钮
进入 AionClaw 控制台 →「界面设置」→「快捷指令」→ 点击「+ 新建」→ 输入自然语言指令(例如:“导出本周飞书会议纪要为PDF并邮件发送给张经理”)→ 保存后自动在右下角悬浮面板生成按钮。整个过程不写一行 HTML/JS,所有逻辑由 Hermes Agent 自动绑定已有技能链路。
方法二:仅修改 ui/custom-links.json
该文件是唯一允许用户手动编辑的前端配置项,格式为纯 JSON 数组,每条记录只含 label、url 和 icon 三字段。添加新入口时,url 必须指向 AionClaw 内置协议地址(如 aionclaw://skill?name=pdf-merge),【禁止填外部 HTTP 链接或 JS 脚本】,否则将绕过权限沙箱,触发安全拦截。
必须动后端逻辑时的最小侵入操作
第一步:在 plugins/ 目录新建子文件夹(如 plugins/invoice-validator-v2)
第二步:只放三个必要文件:manifest.json(声明依赖与权限)、main.py(核心函数入口)、schema.json(输入参数定义)
第三步:在 manifest.json 中将 "scope" 字段设为 "isolated",并明确列出仅可读取的本地路径(如 ["./data/invoices/", "./config/tax-rules.json"])
第四步:通过控制台「插件管理」上传该文件夹 → 启用 → 绑定到指定技能节点
这种插件机制强制限定作用域,即使代码存在逻辑错误,也只导致该技能失败,不会影响其他技能运行或主进程稳定性。











