Skills 完整使用手册（从安装到自建）
约 1 分钟
1) Skill 是什么
Skill 就是一个能力包，本质是一个文件夹，里面至少有一个 SKILL.md。
它告诉智能体：
- 什么时候用这个能力。
- 用什么工具。
- 规则和边界是什么。
2) Skills 放在哪里
按优先级（高到低）：
<workspace>/skills~/.openclaw/skills- 内置 Skills
同名冲突时，高优先级覆盖低优先级。
3) 用 ClawHub 安装 Skills
常用命令：
clawhub install <skill-slug>
clawhub update --all
clawhub sync --all4) 配置 Skills（~/.openclaw/openclaw.json）
{
"skills": {
"allowBundled": ["gemini", "peekaboo"],
"load": {
"extraDirs": ["~/Projects/my-skills"],
"watch": true,
"watchDebounceMs": 250
},
"install": {
"preferBrew": true,
"nodeManager": "npm"
},
"entries": {
"my-skill": {
"enabled": true,
"env": { "API_KEY": "xxx" }
}
}
}
}5) 30 秒创建你的第一个 Skill
mkdir -p ~/.openclaw/workspace/skills/hello-world在该目录写 SKILL.md：
---
name: hello_world
description: A simple skill that says hello.
---
# Hello World Skill
When the user asks for a greeting, use the echo tool to say hello.然后刷新 skills 或重启 gateway。
6) 安全重点
- 第三方 Skill 当作不受信任代码看待。
- 启用前先读
SKILL.md和脚本。 - 关键能力放在沙箱内运行。
- 敏感密钥不要写在提示词里，用
env/apiKey注入。
7) 常见误区
- 只装不用：装了不读规则，最容易翻车。
- 乱开权限：技能是“能力”，权限才是“边界”。
- 不做版本管理：建议固定关键技能版本。
练习任务
- 从 ClawHub 安装 2 个技能。
- 禁用 1 个高风险技能并写出原因。
- 自建 1 个最小技能并在对话中触发成功。