Skills
Skills(OpenClaw)
OpenClaw 使用兼容 AgentSkills 的 Skills 文件夹来教智能体如何使用工具。每个 Skills 是一个包含带有 YAML frontmatter 和说明的 SKILL.md 的目录。OpenClaw 加载内置 Skills 以及可选的本地覆盖,并在加载时根据环境、配置和二进制文件存在情况进行过滤。
位置和优先级
插件可以通过在 openclaw.plugin.json 中列出 skills 目录(相对于插件根目录的路径)来发布自己的 Skills。插件 Skills 在插件启用时加载,并参与正常的 Skills 优先级规则。你可以通过插件配置条目上的 metadata.openclaw.requires.config 对它们进行门控。参见插件了解发现/配置,以及工具了解这些 Skills 所教授的工具接口。
ClawHub(安装 + 同步)
ClawHub 是 OpenClaw 的公共 Skills 注册表。浏览 https://clawhub.com。使用它来发现、安装、更新和备份 Skills。完整指南:ClawHub。
常见流程:
- 将 Skills 安装到你的工作区:
- clawhub install
- 更新所有已安装的 Skills:
- clawhub update --all
- 同步(扫描 + 发布更新):
- clawhub sync --all
默认情况下,clawhub 安装到当前工作目录下的 ./skills(或回退到配置的 OpenClaw 工作区)。OpenClaw 在下一个会话中将其识别为 /skills。
安全注意事项
- 对于不受信任的输入和高风险工具,优先使用沙箱隔离运行。参见沙箱隔离。
- skills.entries.*.env 和 skills.entries.*.apiKey 为该智能体轮次将秘密注入到宿主机进程中(而非沙箱)。将秘密保持在提示词和日志之外。
- 有关更广泛的威胁模型和检查清单,参见安全性。
格式(AgentSkills + Pi 兼容)
- 可选的 frontmatter 键:
- homepage — 在 macOS Skills UI 中显示为"Website"的 URL(也支持通过 metadata.openclaw.homepage)。
- user-invocable — true|false(默认:true)。当为 true 时,Skills 作为用户斜杠命令暴露。
- disable-model-invocation — true|false(默认:false)。当为 true 时,Skills 从模型提示词中排除(仍可通过用户调用使用)。
- command-dispatch — tool(可选)。当设置为 tool 时,斜杠命令绕过模型直接调度到工具。
- command-tool — 当设置 command-dispatch: tool 时要调用的工具名称。
- command-arg-mode — raw(默认)。对于工具调度,将原始参数字符串转发到工具(无核心解析)。
- 如果智能体处于沙箱隔离状态,二进制文件也必须存在于容器内部。通过 agents.defaults.sandbox.docker.setupCommand(或自定义镜像)安装它。setupCommand 在容器创建后运行一次。包安装还需要网络出口、可写的根文件系统和沙箱中的 root 用户。示例:summarize Skills(skills/summarize/SKILL.md)需要 summarize CLI 在沙箱容器中才能运行。
OpenClaw 作为安装的一部分(npm 包或 OpenClaw.app)发布一组基线 Skills 作为内置 Skills。~/.openclaw/skills 用于本地覆盖(例如,在不更改内置副本的情况下固定/修补 Skills)。工作区 Skills 由用户拥有,在名称冲突时覆盖两者。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/238235.html