打造你的專屬 OpenClaw Skill：擴充 AI 助理的功能

每次在用 AI Agent 的時候，總會遇到那種「就差一點點」的情況。你可能希望它能幫你跑一個特定的腳本，或是用特定的方式處理資料，但預設的功能就是沒辦法完全貼合你的需求。與其等待官方更新，不如直接動手擴充它。

OpenClaw 的設計核心就是易於擴充。所謂的 “Skill”，其實就是讓你的助理學會新技能的最直接方式。

需要準備的東西

在開始之前，請確保你已經準備好以下東西：

• 已安裝並運行中的 OpenClaw
• 基本的終端機（Terminal）操作能力
• 對 YAML 與 Markdown 有基礎了解

Quick Start：5 分鐘建立第一個 Skill

建立 Skill 不需要複雜的編程，只需要建立一個資料夾和一個檔案。

1. 建立目錄

所有自定義的 Skills 都存放在你的 workspace 中，路徑通常是 ~/.openclaw/workspace/skills/。打開你的終端機，為新技能建立一個資料夾：

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

2. 定義 SKILL.md

在該目錄下建立一個名為 SKILL.md 的檔案。這個檔案會使用 YAML frontmatter 來定義元數據，並用 Markdown 來寫指令。

貼上以下內容到 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 from your custom skill!".

3. 加入 Tools（選配）

你可以在 frontmatter 中定義自定義工具，或者直接在指令中要求 Agent 使用現有的系統工具（例如 bash 或 browser）。

4. 刷新 OpenClaw

要讓 OpenClaw 抓到新技能，你可以直接對著 Agent 說「refresh skills」，或者是重啟你的 Gateway。OpenClaw 會自動掃描目錄並索引你的 SKILL.md。

最佳實踐與注意事項

為了確保你的 Skill 跑得順暢，建議遵循以下原則：

• 保持簡潔：直接告訴模型「要做什麼」，而不是教它「如何當一個 AI」。
• 安全至上：如果你的 Skill 會用到 bash，請確保你的提示詞（Prompt）不會讓未經過濾的使用者輸入直接變成可執行的指令。
• 本地測試：在正式使用前，可以透過 CLI 快速測試：

  openclaw agent --message "use my new skill"

疑難排解

• 新技能沒反應？ 試著重啟 Gateway，或確認 SKILL.md 的檔名與路徑是否正確。
• 指令執行失敗？ 檢查 bash 指令的權限，並確保 Agent 有權限存取該路徑。

如果你在設定過程中遇到任何問題，可以直接詢問我們的 AI Setup Assistant。

下一步

• 探索更多 Skill：去 ClawHub 看看社群分享的成果，你也可以貢獻自己的 Skill。
• 進階工具定義：深入了解如何在 frontmatter 中定義更複雜的 API 呼叫。