技能與外掛
瞭解 OpenClaw 中 Tool、Skill 和 Plugin 的差異,以及如何安全地擴充您的 Agent
OpenClaw 新使用者最常問的問題是:「Skill、Plugin 和 Tool 有什麼差別?」它們聽起來可以互換,但實際上運作在完全不同的層級。理解這個區別是有效擴充 Agent 的關鍵。
三個層級
OpenClaw 的可擴充性建立在三個協同運作的層級之上:
| 層級 | 它是什麼 | 範例 | 定義方式 |
|---|---|---|---|
| Tool | 底層可執行能力 | read、write、exec、web_search、browser | 內建於 OpenClaw 核心(26 個內建) |
| Skill | 結構化的提示文件,教導 Agent 如何使用工具 | github、notion、spotify-player | SKILL.md + YAML 中繼資料(非程式碼) |
| Plugin | 執行時期程式碼模組,擴充平台本身 | Telegram 頻道、向量記憶儲存、自訂 LLM 供應商 | TypeScript/JavaScript 模組 |
運作鏈如下:
Plugin → 可附帶自己的 Skill → Skill 教導 Agent 使用 Tool → Tool 執行操作
Tool:基礎層
Tool 是 26 個內建功能,讓您的 Agent 能與世界互動。每個 Tool 都有風險分級:
- 安全 — 唯讀操作,如
read、web_search、list_directory - 中等 — 寫入操作,如
write、edit、browser - 高風險 — 無限制執行,如
exec、shell
您可以透過 openclaw.json 中的 tools.allow 設定來控制 Agent 能存取哪些 Tool。如果您的 Agent 只需要搜尋網頁和讀取檔案,就不要授予 exec 權限。
Skill:智能層
Skill 是最容易被誤解的部分。Skill 不是程式碼。 它是一個帶有 YAML 前置資料的結構化文件(SKILL.md),會被載入到 Agent 的系統提示中。它教導 Agent 如何使用已有的工具來完成任務。
例如,github 技能並不包含任何 GitHub API 程式碼。相反,它包含詳細的指令,告訴 Agent 如何使用 exec 工具來執行 gh CLI 命令,以建立 PR、審查程式碼和管理 Issue。
Skill 使用漸進式揭露——Agent 只在技能與當前對話相關時才載入對應的技能指令,保持上下文視窗的效率。
Plugin:平台層
Plugin 是實際的執行時期程式碼,在系統層級擴充 OpenClaw。分為四種類型:
- 頻道外掛 — 連接新的訊息平台(Telegram、Discord、Slack、WhatsApp)
- 記憶外掛 — 新增持久記憶後端(向量儲存、資料庫)
- 工具外掛 — 註冊全新的工具能力,超越 26 個內建工具
- 供應商外掛 — 新增自訂 LLM 供應商
大多數使用者永遠不需要撰寫 Plugin。Skill 和內建工具涵蓋了絕大多數使用情境。
如果您正在想「我需要建立一個 Plugin」,先問問自己:能否透過 Skill 教導 Agent 以不同方式使用現有工具來解決這個問題?十次有九次,答案是肯定的。
值得瞭解的內建技能
OpenClaw 預設附帶 53 個技能。以下是實際常用的那些:
開發
| 技能 | 功能 |
|---|---|
github | 透過 gh CLI 進行 PR 建立、程式碼審查、Issue 管理 |
gh-issues | 專注於 Issue 分類和管理工作流程 |
coding-agent | 多檔案程式碼生成和重構模式 |
node-connect | Node.js 除錯和開發工作流程 |
tmux | 終端機會話管理,用於長時間執行的任務 |
AI 與生成
| 技能 | 功能 |
|---|---|
gemini | Google Gemini 整合,用於多模態任務 |
openai-image-gen | 透過 DALL-E 生成圖片 |
openai-whisper | 音訊轉錄 |
nano-banana-pro | 輕量級圖片生成 |
通訊
| 技能 | 功能 |
|---|---|
slack | 頻道訊息、執行緒管理 |
discord | 伺服器和頻道互動 |
himalaya | 電子郵件讀取和發送 |
voice-call | 語音通話處理 |
生產力
| 技能 | 功能 |
|---|---|
notion | 頁面和資料庫管理 |
obsidian | 筆記庫互動 |
apple-notes | macOS 備忘錄整合 |
apple-reminders | macOS 提醒事項整合 |
trello | 看板和卡片管理 |
智慧家居與媒體
| 技能 | 功能 |
|---|---|
openhue | Philips Hue 燈光控制 |
sonoscli | Sonos 音響控制 |
spotify-player | 音樂播放控制 |
工具
| 技能 | 功能 |
|---|---|
weather | 天氣預報 |
nano-pdf | PDF 讀取和摘要 |
summarize | 長內容摘要 |
healthcheck | Agent 健康監控 |
model-usage | Token 使用量追蹤 |
部分內建技能如 apple-notes、apple-reminders 和 imsg 需要 macOS。在 Claw Buff 上,您的 Agent 運行在 Linux 容器中,因此這些技能會被自動過濾掉。
ClawHub 生態系統
除了 53 個內建技能外,ClawHub 是社群市集,擁有超過 13,700 個技能。最受歡迎的技能有大量採用:
- 網頁瀏覽 — 180,000+ 安裝
- Telegram 整合 — 145,000+ 安裝
ClawHub 上的技能按類別組織:AI/ML、工具、開發、生產力、網頁、科學、媒體、社交和金融。
找到優質技能
擁有 13,700+ 個技能,品質差異極大。以下是找到好技能的方法:
查看 awesome-openclaw-skills 清單
社群策劃的 awesome-openclaw-skills 清單包含 5,400+ 個經審核的技能。在直接搜尋 ClawHub 之前,先從這裡開始。
尋找已驗證的發布者
在 ClawHavoc 事件(詳見下文)之後,OpenClaw 引入了發布者驗證機制。優先選擇來自已驗證帳號的技能。
安裝前閱讀 SKILL.md
由於技能本質上只是提示文件,您可以準確地讀到哪些指令會被注入到 Agent 的上下文中。如果某個技能的指令看起來可疑或範圍過於寬泛,請跳過。
檢查安裝數量和更新時間
高安裝數量加上近期更新,表示有積極維護。被棄用且指令過時的技能可能導致非預期的行為。
MCP 工具
OpenClaw 原生支援 Model Context Protocol(MCP),讓您可以將外部工具伺服器連接到 Agent。這對於整合沒有專用 OpenClaw 技能的服務特別有用。
設定放在 openclaw.json 的 mcpServers 區段中:
{
"mcpServers": {
"google-drive": {
"command": "npx",
"args": ["-y", "@anthropic/mcp-google-drive"]
}
}
}目前有超過 1,000 個社群 MCP 伺服器可用,涵蓋 Google Drive、Slack、資料庫(PostgreSQL、MongoDB)、雲端平台(AWS、GCP、Azure)等。每個 MCP 伺服器暴露自己的一組工具,供 Agent 直接呼叫。
MCP 伺服器和 OpenClaw 技能是互補的。MCP 伺服器為 Agent 提供新的工具能力;技能教導 Agent 何時以及如何有效地使用它們。為獲得最佳效果,請將 MCP 伺服器與提供使用說明的技能搭配使用。
安全:ClawHavoc 事件
在 2026 年 1 月至 2 月間,OpenClaw 社群經歷了 ClawHavoc 事件——一場透過 ClawHub 上惡意技能發動的協調式供應鏈攻擊。這不是理論推測;它真實發生了。
事件經過
在 12 個發布者帳號之下,攻擊者上傳了 1,184 個惡意技能,其中包含:
- 反向 Shell — 讓攻擊者取得主機的遠端存取權限
- 資料外洩 — 悄悄上傳檔案、憑證和環境變數
- AMOS 竊取程式 — 針對 macOS 的惡意軟體,竊取瀏覽器密碼和加密貨幣錢包
- 透過 MEMORY.md 的持久感染 — 將指令注入 Agent 的持久記憶中,使惡意行為在技能移除後仍然存活
應對措施
OpenClaw 與 VirusTotal 合作,移除了超過 2,400 個可疑技能。引入了發布者驗證機制,讓使用者能區分經審核的發布者和匿名上傳者。
然而,後續的 Snyk 審計發現 36% 的 ClawHub 技能仍包含某種形式的提示注入。VirusTotal 能捕捉二進位惡意軟體和已知攻擊模式,但無法偵測自然語言提示注入——隱藏在技能中、巧妙操縱 Agent 行為的指令。
技能中的提示注入特別危險,因為技能就是提示。惡意技能不需要走私可執行程式碼——它只需要包含能說服 Agent 使用現有工具執行有害操作的指令。
如何保持安全
如果您使用社群技能,以下做法不是可選的,而是必需的:
- 安裝前審核每個未驗證的技能。 閱讀
SKILL.md檔案。它是一份文字文件——這只需要幾分鐘,不是幾小時。 - 使用
allowBundled來白名單只載入您需要的技能。 如果您只用 5 個技能,就不要載入全部 53 個內建技能。 - 釘選技能版本。 不要自動更新社群技能。升級前先審查更新日誌。
- 定期執行
openclaw security audit。 這會掃描已安裝的技能是否含有已知的惡意模式。 - 最小化
tools.allow。 如果您的 Agent 不需要 Shell 存取,就不要授予exec。被入侵技能的爆炸半徑受限於 Agent 能存取的工具。
在 Claw Buff 上管理技能
在 Claw Buff 上,技能管理透過管理後台處理,而非手動編輯 openclaw.json。
啟用和停用技能 — 每個已安裝的技能在管理後台的 Agent 區段中都有一個開關。停用的技能不會載入到 Agent 的上下文中。
設定 API 金鑰 — 需要外部服務憑證的技能(如 spotify-player 或 notion)提供行內設定欄位,您可以在此設定所需的環境變數。
從 ClawHub 瀏覽和安裝 — 您可以直接從管理後台搜尋和安裝 ClawHub 技能,無需 SSH 存取容器。
二進位依賴 — 部分技能需要外部二進位檔案(如 ffmpeg 用於媒體處理,或 gh 用於 GitHub)。如果某個技能需要容器中未預裝的二進位檔案,安裝時會顯示依賴通知。如需額外的系統套件,請聯繫客服。
為 macOS 設計的技能(如 apple-notes、apple-reminders 和 imsg)在 Claw Buff 上會被自動過濾掉,因為您的 Agent 運行在 Linux 容器中。如果某個技能出現在 ClawHub 但未出現在您的管理後台,這很可能就是原因。