aionclaw默认不暴露技能管理界面,所有扩展必须通过http://localhost:8080/dev入口安装;支持拖拽zip包、本地路径导入及社区仓库一键安装三种方式,首次安装后生成allowlist.json权限白名单,未生效需强制重启网关。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想给AionClaw装上查天气、自动填表、抓网页数据这类实用技能,但点开插件市场却找不到安装入口,也不清楚SKILL.md文件怎么用——这不是你配置错了,而是AionClaw默认不暴露底层技能管理界面,所有扩展必须通过明确路径触发。
确认AionClaw已运行且进入开发者模式
启动AionClaw客户端,等待右下角状态栏出现绿色「安全保护中」标识;若未出现,说明Gateway守护进程未就绪,需重启客户端并等待30秒以上。
按 Ctrl+Shift+I(Windows/Linux)或 Cmd+Option+I(macOS)唤出内置开发者控制台;此时界面不会弹窗提示,但地址栏会自动跳转至 http://localhost:8080/dev ——这是唯一可访问技能管理后台的合法入口。
【必须在/dev页面完成后续操作,任何其他路径下的“插件”按钮均为无效占位符】
手动安装本地技能包(.zip格式)
方法一:拖拽安装(推荐新手)
将下载好的技能压缩包(如weather-v2.3.zip)直接拖入/dev页面空白区域,松手后自动解压并校验签名;若顶部弹出红色报错“Signature mismatch”,说明该技能未经AionClaw官方或社区可信签名,需手动点击「强制启用」并确认风险。
方法二:路径导入(适合批量部署)
点击/dev页面左上角「Import Skill」→ 选择「From Local Path」→ 在弹出窗口中定位到你存放技能包的文件夹(例如~/Downloads/aic-skills/)→ 勾选目标.zip文件 → 点击「Load & Validate」。
这一步会扫描包内必需的SKILL.md和main.py,缺任一文件则立即终止,不写入系统。
从社区仓库一键安装(需联网)
第一步:在/dev页面点击「Browse Community」
第二步:在搜索框输入关键词(如“飞书打卡”“PDF转Excel”),回车后列表仅显示已通过三重校验的技能(来源核验+代码扫描+权限沙箱测试)
第三步:找到目标技能条目,点击右侧「Install」按钮 → 弹窗提示「将请求以下权限:读取桌面文件、控制浏览器、发送通知」→ 勾选确认 → 安装进度条走完即生效
注意:首次安装社区技能时,AionClaw会自动生成~/.aionclaw/skills/allowlist.json,记录你授权过的技能ID与权限组合,此文件不可删除,否则所有已装技能将失效。
验证技能是否激活成功
打开AionClaw主界面,输入指令:“列出我当前可用的技能” → 系统将返回带图标、版本号、最后更新时间的完整清单。
若刚安装的技能未出现在列表中,不要重复点击安装按钮;先关闭客户端,再终端执行:killall -9 aionclaw-gateway && open -a AionClaw(macOS)或taskkill /f /im aionclaw-gateway.exe && start AionClaw.exe(Windows)强制刷新运行时上下文。










