概念

Skill 是 OpenClaw 的「技能包」— 可重用的指令和腳本集合。

與內建 tools 不同，skills 是用戶可以自己建立和分享的。

Skill 結構

skills/
└── weather/
    ├── SKILL.md           # 必要：skill 說明和使用指南
    ├── get-weather.sh     # 可選：腳本
    └── format.py          # 可選：其他檔案

Skill 載入位置

優先順序（高 → 低）：
1. Workspace skills: <workspace>/skills/
2. Local skills: ~/.openclaw/skills/
3. Bundled skills: /opt/homebrew/lib/node_modules/openclaw/skills/

SKILL.md 格式

# Weather Skill

## Description
Get current weather and forecasts (no API key required).

## When to use
- User asks about weather
- User mentions going outside
- Planning outdoor activities

## Usage
Run: `curl wttr.in/<city>?format=3`

## Examples
```bash
# Get weather for Taipei
curl wttr.in/Taipei?format=3

# Get detailed forecast
curl wttr.in/Taipei

Notes

Works worldwide
No API key needed
Rate limited to ~100 req/day


---

## 核心代碼

### 1. Skill 載入

```typescript
function loadSkills(workspace) {
  const skills = [];
  
  // 三個位置
  const locations = [
    `${workspace}/skills`,
    `${HOME}/.openclaw/skills`,
    `${INSTALL_PATH}/skills`
  ];
  
  for (const dir of locations) {
    if (!exists(dir)) continue;
    
    for (const skillDir of listDirs(dir)) {
      const skillMd = `${skillDir}/SKILL.md`;
      
      if (exists(skillMd)) {
        skills.push({
          name: basename(skillDir),
          path: skillDir,
          content: readFile(skillMd)
        });
      }
    }
  }
  
  return skills;
}

2. Skill 注入到 Prompt

// 載入的 skills 會注入到 system prompt
function buildSkillsPrompt(skills) {
  return `
<available_skills>
${skills.map(s => `
  <skill>
    <name>${s.name}</name>
    <description>${extractDescription(s.content)}</description>
    <location>${s.path}/SKILL.md</location>
  </skill>
`).join('')}
</available_skills>

Use the read tool to load a skill's file when the task matches its description.
`;
}

3. Agent 使用 Skill

// Agent 看到 skill 清單後
// 1. 判斷任務是否符合某個 skill
// 2. 用 read tool 讀取 SKILL.md
// 3. 依照指示執行

// 範例：用戶問天氣
// Agent 思考：這符合 weather skill
// Agent 呼叫：read("/opt/homebrew/.../skills/weather/SKILL.md")
// Agent 執行：exec("curl wttr.in/Taipei?format=3")

建立自己的 Skill

1. 建立目錄

mkdir -p ~/.openclaw/skills/my-skill

2. 寫 SKILL.md

# My Custom Skill

## Description
Brief description of what this skill does.

## When to use
- Situation 1
- Situation 2

## Usage
Step-by-step instructions for the agent.

## Scripts
- `run.sh`: Main script
- `helper.py`: Helper functions

## Examples
\`\`\`bash
./run.sh arg1 arg2
\`\`\`

3. 加入腳本

# ~/.openclaw/skills/my-skill/run.sh
#!/bin/bash
echo "Hello from my skill!"

4. 測試

# 重啟 gateway
openclaw gateway restart

# 問 agent
"Use my-skill to do something"

內建 Skills 範例

ls /opt/homebrew/lib/node_modules/openclaw/skills/

# 輸出
coding-agent/    # 控制 Codex/Claude Code
github/          # GitHub CLI 整合
gog/             # Google Workspace
healthcheck/     # 安全審計
openai-image-gen/# 圖片生成
openai-whisper/  # 語音轉文字
session-logs/    # 分析舊對話
skill-creator/   # 建立新 skill
weather/         # 天氣查詢

💡 關鍵洞察

Skills 是「說明書」
- 不是 code，是指示
- Agent 讀了之後知道怎麼做
- 可以包含腳本路徑
SKILL.md 是入口
- 必須有這個檔案
- Agent 看 description 決定用不用
- 詳細指示在裡面
可以分享 Skills
- ClawHub: https://clawhub.com
- 複製目錄就能用
- 社群貢獻
Workspace Skills 優先
- 同名 skill 會覆蓋
- 可以客製化內建 skill
- 放在 workspace/skills/

Skill 最佳實踐

原則	說明
簡潔	一個 skill 做一件事
範例	提供具體使用範例
錯誤處理	說明常見問題
依賴	列出需要的工具

🔗 核心檔案

Skills 文檔：/opt/homebrew/lib/node_modules/openclaw/docs/tools/skills.md
Creating Skills：/opt/homebrew/lib/node_modules/openclaw/docs/tools/creating-skills.md
內建 Skills：/opt/homebrew/lib/node_modules/openclaw/skills/

Day 18: Skills 系統（如何寫自己的 skill）