| 特性 | BUILT_IN SKILLS (内置技能) | WORKSPACE SKILLS (工作区技能) | EXTRA SKILLS (扩展/自定义技能) |
| 定义 | 系统核心自带的通用能力,随软件安装默认存在。 | 当前项目专属的技能,仅在当前打开的项目目录中生效。 | 用户全局安装或从社区下载的第三方技能,位于用户主目录。 |
| 存储位置 | 系统安装目录 (如 /usr/lib/openclaw/skills 或包内资源) | 当前项目根目录下的 .openclaw/skills/ 文件夹 | 用户主目录 ~/.openclaw/skills/ |
| 作用范围 | 全局。对所有项目都可用。 | 局部。仅对当前打开的特定项目(Workspace)有效。 | 全局。对所有项目可用,但优先级低于工作区技能。 |
| 修改权限 | 只读。不建议直接修改,升级时会覆盖。 | 完全可控。随项目代码一起版本控制 (Git)。 | 可编辑。用户可自由修改、删除或更新。 |
| 典型用途 | 基础文件操作、Shell 执行、代码搜索、基础 Git 命令。 | 项目特有的构建脚本、内部 API 调用规范、特定测试流程。 | 行业专用工具(如 SQL 优化器)、个人偏好模板、社区热门插件。 |
| 优先级 | 最低 (作为兜底能力)。 | 最高 (覆盖同名内置或扩展技能)。 | 中等 (高于内置,低于工作区)。 |