开发12 分钟阅读高级

技能与插件

扩展社区技能或构建自己的。AI 甚至可以编写自己的技能

你将学到

  • OpenClaw 如何从多个位置加载和管理技能
  • 技能优先级规则和工作区 vs 共享技能
  • 通过 ClawHub 安装和管理技能
  • SKILL.md 格式和前置元数据
  • 基于环境和配置的技能过滤
  • 第三方技能的安全最佳实践

技能概览

OpenClaw 使用兼容 AgentSkills 的技能文件夹来教代理如何使用工具。每个技能是一个包含 SKILL.md 的目录,其中包含 YAML 前置元数据和说明。

SKILL.md 必须至少包含 YAML 前置元数据中的 name 和 description

技能位置

技能从三个位置加载,工作区优先级最高:

内置技能

随安装一起提供(npm 包或 OpenClaw.app)

托管/本地技能

~/.openclaw/skills - 本地覆盖,对所有代理可见

工作区技能

\<workspace\>/skills - 用户拥有,优先级最高

优先级规则

优先级顺序(从高到低)

工作区托管/本地内置

如果技能名称冲突,工作区胜出,然后是托管/本地,最后是内置

ClawHub - 技能注册表

ClawHub 是 OpenClaw 的公共技能注册表。在 https://clawhub.com 浏览、发现、安装、更新和备份技能。

安装技能

clawhub install [skill-slug]

更新所有技能

clawhub update --all

技能格式 (SKILL.md)

SKILL.md 必须包含至少 name 和 description 的 YAML 前置元数据:

---
name: my-skill
---
# 你的技能说明放在这里
使用 baseDir 变量引用技能文件夹。
name (必需)

技能的唯一标识符

description (必需)

技能的功能描述

metadata.openclaw.requires

过滤条件: bins、env、config、os

user-invocable

作为斜杠命令暴露(默认: true)

安全注意事项

将技能视为可信代码

启用前请阅读第三方技能的代码。对于不可信的输入,优先使用沙箱运行。

  • !技能可以在你的系统上执行任意代码
  • !将机密信息保存在提示和日志之外
  • !安装前审查技能代码
  • !使用技能过滤来控制访问

继续学习

技能只是扩展 OpenClaw 的一种方式。探索更多教程和文档: