建立技能

技能會教導代理如何以及何時使用工具。每個技能都是一個目錄，其中包含一個帶有 YAML 前置資訊和 Markdown 指令的 SKILL.md 檔案。

關於如何載入和優先排序技能，請參閱 Skills。

建立您的第一個技能

建立技能目錄
技能位於您的工作區中。建立一個新資料夾：
Terminal window
```
mkdir -p ~/.openclaw/workspace/skills/hello-world
```
撰寫 SKILL.md
在該目錄中建立 SKILL.md。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!".
```
技能的 name 請使用小寫字母、數字和連字號的連字號寫法（hyphen-case）。請保持資料夾名稱與 frontmatter 中的 name 一致。
新增工具（選用）
您可以在 frontmatter 中定義自訂工具架構，或指示代理程式使用現有的系統工具（例如 exec 或 browser）。技能也可以隨同其記載的工具一起在插件內發布。
載入技能
啟動新的工作階段，讓 OpenClaw 載入該技能：
Terminal window
```
# From chat
/new

# Or restart the gateway
openclaw gateway restart
```
驗證技能是否已載入：
Terminal window
```
openclaw skills list
```
進行測試
傳送一則應觸發該技能的訊息：
Terminal window
```
openclaw agent --message "give me a greeting"
```
或者直接與代理交談並要求打招呼。

YAML 前置資訊支援以下欄位：

欄位	必要	說明
`name`	是	使用小寫字母、數字和連字號的唯一識別碼
`description`	是	顯示給代理的單行描述
`metadata.openclaw.os`	否	OS 篩選器（`["darwin"]`、`["linux"]` 等）
`metadata.openclaw.requires.bins`	否	PATH 中必要的二元檔案
`metadata.openclaw.requires.config`	否	必要的設定金鑰