创建自定义技能

OpenClaw 的设计让扩展变得很简单。“技能”是给你的助手添加新能力的主要方式。

什么是技能?

技能就是一个目录,里面包含一个 SKILL.md 文件(提供指令和工具定义给 LLM)以及可选的脚本或资源。

分步教程:你的第一个技能

1. 创建目录

技能放在你的工作区里,通常是 ~/.openclaw/workspace/skills/。为你的技能创建一个新文件夹:

mkdir -p ~/.openclaw/workspace/skills/hello-world

2. 编写 SKILL.md

在目录中创建一个 SKILL.md 文件。这个文件用 YAML frontmatter 定义元数据,用 Markdown 写指令。

---
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 from your custom skill!".

3. 添加工具(可选)

你可以在 frontmatter 中定义自定义工具,也可以指示代理使用已有的系统工具(比如 bashbrowser)。

4. 刷新 OpenClaw

让代理”刷新技能”或者重启网关。OpenClaw 会发现新目录并索引 SKILL.md

最佳实践

  • 简洁明了:告诉模型_做什么_,不用教它怎么当 AI。
  • 安全第一:如果技能用到 bash,确保提示不会让不可信的用户输入注入任意命令。
  • 本地测试:用 openclaw agent --message "use my new skill" 来测试。

共享技能

你也可以在 ClawHub 上浏览和贡献技能。