建立技能

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

如需了解技能如何載入和排定優先順序，請參閱 Skills。

建立您的第一個技能

建立技能目錄
技能位於您的工作區中。建立一個新資料夾：
Terminal window
```
mkdir -p ~/.openclaw/workspace/skills/hello-world
```

撰寫 SKILL.md

在該目錄中建立 SKILL.md。前置資料定義中繼資料，而 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!".

新增工具 (選用)
您可以在前置資料中定義自訂工具綱要，或指示代理程式使用現有的系統工具 (例如 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`	是	唯一識別碼 (snake_case)
`description`	是	顯示給代理程式看的單行說明
`metadata.openclaw.os`	否	作業系統篩選器 (`["darwin"]`, `["linux"]`, 等)
`metadata.openclaw.requires.bins`	否	PATH 上必要的二元檔
`metadata.openclaw.requires.config`	否	必要的設定金鑰

最佳實務

保持簡潔 — 指示模型做什麼，而不是如何成為 AI
安全第一 — 如果您的技能使用了 exec，請確保提示不允許來自不受信任輸入的任意命令注入
本機測試 — 在分享之前使用 openclaw agent --message "..." 進行測試
使用 ClawHub — 在 ClawHub 瀏覽和貢獻技能

技能的存放位置

位置	優先順序	範圍
`\<workspace\>/skills/`	最高	單一代理程式
`~/.openclaw/skills/`	中等	共享（所有代理程式）
內建（隨 OpenClaw 附帶）	最低	全域
`skills.load.extraDirs`	最低	自訂共享資料夾

建立技能

建立技能

建立您的第一個技能

技能中繼資料參考

最佳實務

技能的存放位置

相關