aionclaw skill 必须通过 skill.json 的 conditions 字段声明设备、系统版本或权限条件,否则默认全局开放;需配置 os、arch、min_version 等字段,支持 device_ids 白名单或 phone_required 手机号校验,并重启网关后验证状态标签与调用反馈。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让 AionClaw 的 Skill 在特定设备、系统版本或用户权限下才生效,必须通过修改其配置文件显式声明使用条件,否则该 Skill 将对所有环境开放——这可能引发兼容性报错或安全越权行为。
确认 Skill 目录结构
进入 ~/.openclaw/skills/ 目录,找到目标 Skill 文件夹(例如 weather-v1.2.3),确保其中已存在 SKILL.md 和 skill.json 两个核心文件。
若缺少 skill.json,需手动创建;仅靠 SKILL.md 无法定义运行时条件。
在 skill.json 中添加 conditions 字段
用文本编辑器打开 skill.json,在根对象内插入 "conditions" 键,值为对象:
"conditions": { "os": ["macos", "windows"], "arch": ["arm64", "x86_64"], "min_version": "1.2.0" }
其中 os 限定操作系统类型,arch 控制 CPU 架构支持,min_version 表示该 Skill 最低兼容的 AionClaw 客户端版本。不填写某一项即视为无限制。
【min_version 必须与当前 AionClaw 版本号格式一致,如 v2.1.0-beta 不可简写为 2.1.0,否则条件判断失效】
设置设备级白名单(可选)
方法一:绑定设备 ID
在 conditions 对象中追加 "device_ids": ["ABC123XYZ", "DEF456UVW"],值为从 AionClaw「个人中心→设备管理」中复制的真实设备 ID 列表。
方法二:启用手机号校验
添加 "phone_required": true,此时 Skill 启用前会强制弹出手机号验证窗口,仅已绑定且通过短信校验的号码可解锁使用。
注意:启用 phone_required 后,未完成实名认证的账号将无法加载该 Skill,且无法跳过。
验证条件是否生效
第一步:执行 openclaw gateway restart 重启网关服务。
第二步:在客户端「技能管理」页面找到该 Skill,观察右上角状态标签——若显示「受限」或「未满足条件」,说明配置已读取。
第三步:切换至一台不满足条件的设备(如 macOS M 系统但未在 device_ids 列表中),尝试调用该 Skill,应直接返回“当前环境不支持此功能”提示,不进入执行流程。











