English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Plugins

管理 Plugin

大多數 Plugin 工作流程只需要幾個命令：搜尋、安裝、重新啟動 Gateway、驗證，並在不再需要 Plugin 時解除安裝。

列出 Plugin

openclaw plugins list
openclaw plugins list --enabled
openclaw plugins list --verbose
openclaw plugins list --json

指令碼請使用 --json。當 Plugin 套件宣告 dependencies 或 optionalDependencies 時，它會包含登錄檔診斷資訊，以及每個 Plugin 的靜態 dependencyStatus。

openclaw plugins list --json \
  | jq '.plugins[] | {id, enabled, format, source, dependencyStatus}'

plugins list 是冷啟動清查檢查。它顯示 OpenClaw 可從設定、manifest 和 Plugin 登錄檔中發現的內容；它不會證明已執行中的 Gateway 程序已匯入 Plugin 執行階段。

安裝 Plugin

# Search ClawHub for plugin packages.
openclaw plugins search "calendar"

# Bare package specs try ClawHub first, then npm fallback.
openclaw plugins install <package>

# Force one source.
openclaw plugins install clawhub:<package>
openclaw plugins install npm:<package>

# Install a specific version or dist-tag.
openclaw plugins install clawhub:<package>@1.2.3
openclaw plugins install clawhub:<package>@beta
openclaw plugins install npm:@scope/[email protected]
openclaw plugins install npm:@openclaw/codex

# Install from git or a local development checkout.
openclaw plugins install git:github.com/acme/[email protected]
openclaw plugins install ./my-plugin
openclaw plugins install --link ./my-plugin

安裝 Plugin 程式碼後，重新啟動為你的頻道提供服務的 Gateway：

openclaw gateway restart
openclaw plugins inspect <plugin-id> --runtime --json

當你需要證明 Plugin 已註冊執行階段介面，例如工具、hook、服務、Gateway 方法或 Plugin 擁有的 CLI 命令時，請使用 inspect --runtime。

更新 Plugin

openclaw plugins update <plugin-id>
openclaw plugins update <npm-package-or-spec>
openclaw plugins update --all

如果 Plugin 是從 npm dist-tag（例如 @beta）安裝，之後呼叫 update <plugin-id> 會重複使用該已記錄的標籤。傳入明確的 npm 規格，會將追蹤的安裝切換為該規格，以供未來更新使用。

openclaw plugins update @scope/openclaw-plugin@beta
openclaw plugins update @scope/openclaw-plugin

第二個命令會在 Plugin 先前被釘選到精確版本或標籤時，將它移回登錄檔的預設發行線。

當 openclaw update 在 beta 頻道上執行時，預設線的 npm 和 ClawHub Plugin 記錄會先嘗試相符的 Plugin @beta 發行版本。如果該 beta 發行版本不存在，OpenClaw 會退回到已記錄的預設/latest 規格。對於 npm Plugin，當 beta 套件存在但安裝驗證失敗時，OpenClaw 也會退回。精確版本和明確標籤（例如 @rc 或 @beta）會被保留。

解除安裝 Plugin

openclaw plugins uninstall <plugin-id> --dry-run
openclaw plugins uninstall <plugin-id>
openclaw plugins uninstall <plugin-id> --keep-files
openclaw gateway restart

解除安裝會移除 Plugin 的設定項目、Plugin 索引記錄、允許/拒絕清單項目，以及適用時的連結載入路徑。除非你傳入 --keep-files，否則受管理的安裝目錄會被移除。

在 Nix 模式（OPENCLAW_NIX_MODE=1）中，Plugin 安裝、更新、解除安裝、啟用和停用命令都會停用。請改為在該安裝的 Nix 來源中管理這些選項；對於 nix-openclaw，請使用 agent-first 快速入門。

發布 Plugin

你可以將外部 Plugin 發布到 ClawHub、npmjs.com，或兩者都發布。

發布到 ClawHub

ClawHub 是 OpenClaw Plugin 的主要公開探索介面。它讓使用者在安裝前取得可搜尋的中繼資料、版本歷程，以及登錄檔掃描結果。

npm i -g clawhub
clawhub login
clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin
clawhub package publish your-org/[email protected]

使用者可透過 ClawHub 安裝：

openclaw plugins install clawhub:<package>
openclaw plugins install <package>

裸格式仍會先檢查 ClawHub。

發布到 npmjs.com

原生 npm Plugin 必須包含 Plugin manifest 和 package.json OpenClaw 進入點中繼資料。

{
  "name": "@acme/openclaw-plugin",
  "version": "1.0.0",
  "type": "module",
  "openclaw": {
    "extensions": ["./dist/index.js"]
  }
}

npm publish --access public

使用者可透過 npm-only 安裝：

openclaw plugins install npm:@acme/openclaw-plugin
openclaw plugins install npm:@acme/openclaw-plugin@beta
openclaw plugins install npm:@acme/[email protected]

如果同一個套件也可在 ClawHub 上取得，npm: 會略過 ClawHub 查詢並強制使用 npm 解析。

來源選擇

  • ClawHub：當你需要 OpenClaw 原生探索、掃描摘要、版本和安裝提示時使用。
  • npmjs.com：當你已經發布 JavaScript 套件，或需要 npm dist-tag/私有登錄檔工作流程時使用。
  • Git：當你想直接從分支、標籤或 commit 安裝時使用。
  • 本機路徑：當你在同一台機器上開發或測試 Plugin 時使用。

相關