OpenClaw 小龙虾技能扩展 Skills

作者：小马过河R
目录

引言一、Skills是什么

1、目录路径2、目录结构3、SKILL.md 文件的编写

二、如何安装 Skills

关于安装的安全问题

三、Skills 注入prompt

引言

之前我们对OpenClaw 小龙虾已经做了整体的介绍《初探来会会OpenClaw这只龙虾》，我们说构成OpenClaw Agent的主要有LLM参数推理、Memery上下文记忆、Rag检索、MCP工具调用、Skills处理经验指南等。其中我们已经分析了记忆机制《OpenClaw 记忆系统工作原理》，今天Skills是本文的重点。

一、Skills是什么

其实如果之前看过编程辅助Skills相关的话《基于Skills驱动的AI编码》应该是比较好懂的，看起来是一模一样，其实没什么差别。
Skills其实就是一个经验技能包，OpenClaw 小龙虾的各种技能扩展都可以通过这个技能包Skills来完成。
1、目录路径

在 macOS/Window 系统中，OpenClaw 的 Skill 目录路径通常为：

1. ~/.openclaw/skills/<skill-name>/

复制代码

此路径为默认的全局 Skill 存放目录，适用于所有用户创建和安装的自定义 Skill。若你希望将某个 Skill 添加到该目录中，可将 Skill 文件夹直接放入此路径下。
此外，OpenClaw 还支持工作区（workspace）级别的 Skill 目录，其路径为：

1. ~/.openclaw/workspace/skills

复制代码

该目录下的 Skill 具有更高的优先级，会优先于全局目录中的 Skill 加载。
如果你使用的是特定的部署方式（如阿里云部署），可能需要根据具体配置调整路径。
如果是智能体内的skills，则可能路径是：

1. ~/.openclaw/workspace/.agent/skills

复制代码

2、目录结构

Skills的目录结构组成和辅助编码一样，
~/.openclaw/skills/

1. my-skill/
2. ├── SKILL.md (必需)        - SKILL“源代码”，核心文件
3. │   ├── YAML 前置元数据 (必需)
4. │   │   ├── name: (必需)
5. │   │   └── description: (必需)
6. │   └── Markdown 指令 (必需)
7. └── 捆绑资源 (可选)
8.     ├── scripts/          - 可执行代码 (Python/Bash等)
9.     ├── references/       - 参考文档
10.     └── assets/           - 输出文件 (模板、图标、字体等)

复制代码

3、SKILL.md 文件的编写

我们找一个clawhub上的Skills： 天气查询 来看下 SKILL.md 文件的编写。

我们可以看到 Skill 是 Markdown 文件，不是编译好的代码。
也就是说：
创建一个 Skill 不一定需要写代码，只需要告诉它要怎么做即可。LLM 在运行时读取 Skill 的 Markdown 内容，理解"怎么做"，然后自己调用工具执行。修改 Skill 不需要重新编译，改完 .md 文件直接生效，但一般建议重启OpenClaw 客户端。
当然，一般情况下我们会需要一些脚本代码来辅助我们技能包的完成功能支撑（可以参考 skills 社区里的各个skills文件，目前 ClawHub 市场有 100+ 社区 Skills）。
二、如何安装 Skills

理论上这是一个 Markdown 文件，编辑或者拷贝在 Skills 目录就能被识别。
https://clawhub.ai/ 这里已经很清晰了。
OpenClaw 本身是一个基于 Node.js 的项目。

如果在终端也可以参考：

1. # 搜索 Skills
2. openclaw skills search weather
4. # 安装 Skills
5. openclaw skills install weather
7. # 安装完 验证
8. openclaw skills info weather
10. # 查看已安装 Skills
11. openclaw skills list
13. # 卸载 Skills
14. openclaw skills remove weather

复制代码

也可以在 Web UI /网关控制台-代理 的 Skills 界面直接浏览和安装。
如果是在 插件/智能体 内安装skills 则由插件决定安装说明。
关于安装的安全问题

1、安装前可以先进行对skills 充分评估和检查，参考inspect命令，检查是否有可执行文件的权限存在等危险动作。
2、可以查看 全局核心配置文件 ~/.openclaw/openclaw.json，定义了系统级行为、多智能体（Agent）路由规则、渠道接入权限、工具策略等关键设置。类似如下：
[code]# ~/.openclaw/openclaw.json{#