⚡

AI Agent 自主代理三王實戰

CH15 | 60+ 技能——讓龍蝦無所不能

龍蝦本身會聊天，但查天氣、管行程、寄 Email 這些需要「跟外部服務互動」的能力，就要靠 Skills（技能）來擴充

📋 本章學習目標

理解 Skills 的概念和運作原理
認識官方 60+ Skills 的九大分類
學會安裝、管理、設定技能
知道哪些技能最值得裝

1 / 11

15.1 什麼是 Skills？

Skills 就像手機上的 App——你的手機本身可以打電話、拍照，但你裝了 Uber 才能叫車、裝了 Foodpanda 才能訂餐。龍蝦也一樣，裝了天氣技能才能查天氣、裝了行事曆技能才能管行程。

在 OpenClaw 的架構裡，Skill 是一個擴充龍蝦能力的模組。每個 Skill 定義了：

龍蝦能做什麼新的事（例如查天氣、寄 Email）
怎麼跟外部服務互動（例如呼叫天氣 API、連接 Gmail）
什麼時候觸發（例如使用者說「天氣」的時候）

💡 一句話總結：AI 模型本身「會思考」，Skills 則讓龍蝦「能行動」。

2 / 11

Skill 運作流程

當你跟龍蝦說「今天台北天氣如何？」，背後發生了六個步驟：

① 傳訊息

你：「今天台北天氣如何？」

② AI 判斷

龍蝦的 AI 大腦判斷：這是在問天氣

③ 選技能

AI 決定使用「天氣技能」

④ 呼叫 API

天氣技能去呼叫天氣 API，拿到資料

⑤ 整理回覆

AI 把天氣資料整理成自然語言

⑥ 回覆你

「今天台北 26°C，多雲偶陣雨...」

✅ 關鍵：AI 模型會自己判斷該用哪個技能。你不需要打特殊指令，用自然語言說話就好。

3 / 11

SKILL.md 格式

每個技能都有一個 SKILL.md 定義檔，告訴龍蝦這個技能是什麼、能做什麼：

---
name: weather
description: 查詢全球各城市的即時天氣、未來預報和氣象資訊。
---

# Weather（天氣查詢）

目標：根據使用者提供的城市或位置，查詢即時天氣資訊。

## 功能
- 查詢即時天氣（溫度、濕度、風速、天氣狀況）
- 查詢未來 3-7 天預報
- 紫外線指數 / 穿衣建議

## 使用方式
- 「今天天氣怎麼樣？」
- 「台北明天會下雨嗎？」
- 「東京這週的天氣預報」

## 需要的設定
- API Key：在 TOOLS.md 裡設定 OpenWeatherMap API Key
- 預設城市：在 TOOLS.md 裡設定使用者所在城市

💡 龍蝦讀了這個檔案，就知道這個技能的用途和使用時機——就像招聘時的「職位說明書」。

4 / 11

15.2 官方 60+ Skills 九大分類（上）

🏠 生活實用類

weather 天氣、news 新聞、rss-reader RSS 訂閱、translate 翻譯、calculator 計算、timer 計時器、recipe 食譜、currency 匯率

💼 生產力類

google-calendar 行事曆、notion 資料庫、email 收寄信、todo 待辦、notes 筆記、summary 摘要、web-search 網頁搜尋

🎮 娛樂社交類

clawra 龍蝦自拍、music 音樂搜尋、joke 講笑話、quote 每日金句、trivia 冷知識

🔧 系統工具類

disk-audit 磁碟盤點、sag 文字轉語音、screenshot 截圖、file-manager 檔案管理、system-monitor 系統監控

5 / 11

15.2 官方 60+ Skills 九大分類（下）

👨‍💻 開發者工具類

git 版本控制、code-review 程式碼審查、docker 容器管理、ssh 遠端伺服器、database 資料庫查詢

☁️ 雲端儲存與文件類

google-drive 雲端硬碟、onedrive OneDrive、doc-converter 格式轉換、pdf-tools PDF 操作、pptx-generator 簡報生成、excel-tools Excel

💰 財經資訊類

stock-tracker 股票報價、crypto-tracker 加密貨幣、finance-news 財經新聞、exchange-rate 匯率走勢

🏡 智慧家庭類

home-assistant HA 整合、camera IP 攝影機、light 智慧燈具控制

📞 通訊與語音類

twilio-voice 語音通話（CH20 詳細教學）、browser-sandbox 瀏覽器自動操控（CH18 詳細教學）

⚡ 不用全部都裝：技能太多反而會讓龍蝦「不知道該用哪個」。建議先裝最需要的 3-5 個，用熟了再慢慢擴充。

6 / 11

15.3 Skills 安裝與管理

搜尋技能

clawdhub search weather

安裝技能

clawdhub install weather
# 或
openclaw skills install weather

查看已安裝技能

openclaw skills list

🔄 啟用 / 停用

openclaw skills disable weather
openclaw skills enable weather

⬆️ 更新

clawdhub update weather
clawdhub update --all

🗑️ 移除

openclaw skills remove weather

⚡ 每次安裝、移除或修改技能後，都要重啟 Gateway：openclaw gateway restart

7 / 11

15.4 推薦必裝 Skills

族群	推薦技能	說明
🆕 新手必裝	weather	最實用，每天都用得到
	todo	待辦事項管理，不需要 API Key
	translate	翻譯功能，零設定
🎮 生活玩家	news	每天看新聞摘要
	clawra	龍蝦自拍，好玩
	recipe	不知道吃什麼超好用
💼 工作族群	google-calendar	行程管理，主動提醒
	email	幫你讀信、回信
	notion	用 Notion 管理工作的人必裝
👨‍💻 開發者	git	在聊天室裡操作 Git
	web-search	搜尋技術文件
	code-review	丟程式碼讓龍蝦幫你看

8 / 11

15.5 Skills 設定與客製化

很多技能需要額外設定才能使用——最常見的就是 API Key。

方式一：寫在 TOOLS.md 裡

## Weather（天氣）
- API Key: 你的OpenWeatherMap_API_Key
- 預設城市: 台北
- 溫度單位: 攝氏

## Google Calendar
- 服務帳號金鑰路徑: ~/.openclaw/workspace/google-credentials.json
- 主要行事曆: 工作

方式二：用 CLI 設定

openclaw config set skills.weather.apiKey 你的API_Key
openclaw config set skills.weather.defaultCity 台北

客製化技能行為

你可以修改技能的 SKILL.md 來客製化行為——例如改成「回覆天氣時用簡短一句話就好」，龍蝦就會照辦。

💡 技能的檔案結構：每個技能是 ~/.openclaw/workspace/skills/ 裡的一個獨立資料夾，包含 SKILL.md 和（可選的）腳本。

📖 所有技能的 API Key 申請步驟和 TOOLS.md 設定範例，請參考附錄 E：Skills 設定速查表——每個技能都有手把手的設定指南。

9 / 11

15.6 常見問題

問題	解決方式
安裝了技能但龍蝦不會用	① 忘記重啟 → `openclaw gateway restart` ② API Key 沒設定 → 檢查 TOOLS.md ③ 技能被停用 → `openclaw skills list` 確認 ④ 說法太含糊 → 明確說「用天氣技能查台北天氣」
技能太多龍蝦搞混	控制在 10 個以內，功能重複的只留一個
我可以自己寫技能嗎？	可以！CH17 會專門教你，門檻不高
技能需要花錢嗎？	技能本身免費，但部分 API 有費用（大部分有免費額度）
技能可以跨通道嗎？	可以。技能跟龍蝦綁定，不跟通道綁定。LINE / TG / Discord 都用同一個技能
哪裡找更多技能？	`clawdhub search 關鍵字`、GitHub、OpenClaw Discord 社群

10 / 11

15.7 小結與展望

📱 Skills 概念

就像手機上的 App，給龍蝦擴充新能力——查天氣、管行程、寄 Email

📦 60+ 官方技能

涵蓋生活、工作、娛樂、開發、雲端、財經、智慧家庭、通訊語音等九大分類

🛠️ 安裝與管理

用 clawdhub 或 openclaw skills 指令一鍵搞定搜尋、安裝、更新、移除

⚙️ 設定與客製化

API Key 寫在 TOOLS.md、行為調整改 SKILL.md，讓技能完全符合你的需求

📖 下一章預告：CH16 天氣、新聞、行事曆——日常超能力
光會「裝技能」還不夠。下一章用六個實際場景教你怎麼把技能組合運用到日常生活中——排程提醒、天氣查詢、新聞摘要、Notion 整合、Google Calendar 整合！

前往 CH16 ➡️

11 / 11