Skip to content

技能與外掛

瞭解 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-playerSKILL.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-connectNode.js 除錯和開發工作流程
tmux終端機會話管理,用於長時間執行的任務

AI 與生成

技能功能
geminiGoogle Gemini 整合,用於多模態任務
openai-image-gen透過 DALL-E 生成圖片
openai-whisper音訊轉錄
nano-banana-pro輕量級圖片生成

通訊

技能功能
slack頻道訊息、執行緒管理
discord伺服器和頻道互動
himalaya電子郵件讀取和發送
voice-call語音通話處理

生產力

技能功能
notion頁面和資料庫管理
obsidian筆記庫互動
apple-notesmacOS 備忘錄整合
apple-remindersmacOS 提醒事項整合
trello看板和卡片管理

智慧家居與媒體

技能功能
openhuePhilips Hue 燈光控制
sonoscliSonos 音響控制
spotify-player音樂播放控制

工具

技能功能
weather天氣預報
nano-pdfPDF 讀取和摘要
summarize長內容摘要
healthcheckAgent 健康監控
model-usageToken 使用量追蹤

部分內建技能如 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 使用現有工具執行有害操作的指令。

如何保持安全

如果您使用社群技能,以下做法不是可選的,而是必需的:

  1. 安裝前審核每個未驗證的技能。 閱讀 SKILL.md 檔案。它是一份文字文件——這只需要幾分鐘,不是幾小時。
  2. 使用 allowBundled 來白名單只載入您需要的技能。 如果您只用 5 個技能,就不要載入全部 53 個內建技能。
  3. 釘選技能版本。 不要自動更新社群技能。升級前先審查更新日誌。
  4. 定期執行 openclaw security audit。 這會掃描已安裝的技能是否含有已知的惡意模式。
  5. 最小化 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 但未出現在您的管理後台,這很可能就是原因。