Plugin

​

要件

• openclaw CLI が利用可能な OpenClaw チェックアウトまたはインストール
• 選択したソース（ClawHub、npm、または git ホスト）へのネットワークアクセス
• その Plugin のセットアップドキュメントで指定されている、Plugin 固有の認証情報、 設定キー、または OS ツール
• チャネルにサービスを提供する Gateway をリロードまたは再起動する権限

​

クイックスタート

openclaw plugins search "calendar"

# From ClawHub.
openclaw plugins install clawhub:<package>

# From npm.
openclaw plugins install npm:<package>

# From git.
openclaw plugins install git:github.com/<owner>/<repo>@<ref>

# From a local development checkout.
openclaw plugins install ./my-plugin
openclaw plugins install --link ./my-plugin

openclaw plugins enable <plugin-id>

openclaw gateway restart

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

​

設定

​

インストールソースを選択する

​

オペレーターインストールポリシー

​

Plugin ポリシーを構成する

{
  plugins: {
    enabled: true,
    allow: ["voice-call"],
    deny: ["untrusted-plugin"],
    load: { paths: ["~/Projects/oss/voice-call-plugin"] },
    slots: { memory: "memory-core" },
    entries: {
      "voice-call": { enabled: true, config: { provider: "twilio" } },
    },
  },
}

• plugins.enabled: false はすべての Plugin を無効化し、検出/読み込み作業をスキップします。 これが有効な間、古い Plugin 参照は不活性のままです。古い id を削除したい場合は、 doctor cleanup を実行する前に Plugin を再有効化してください。
• plugins.deny は allow と Plugin ごとの有効化より優先されます。
• plugins.allow は排他的な allowlist です。allowlist 外の Plugin 所有ツールは、 tools.allow に "*" が含まれていても利用できません。
• plugins.entries.<id>.enabled: false は、設定を保持したまま 1 つの Plugin を無効化します。
• plugins.load.paths は明示的なローカル Plugin ファイルまたはディレクトリを追加します。 管理対象の plugins install ローカルパスは Plugin ディレクトリまたはアーカイブである必要があります。 スタンドアロン Plugin ファイルには plugins.load.paths を使用してください。
• ワークスペース由来の Plugin はデフォルトで無効です。ローカルワークスペースコードを使用する前に、 明示的に有効化するか allowlist に追加してください。
• バンドル済み Plugin は、設定で明示的に上書きされない限り、 組み込みの default-on/default-off メタデータに従います。
• plugins.slots.<slot>（memory または contextEngine）は、排他的カテゴリに対して 1 つの Plugin を選択します。 スロット選択は明示的なアクティベーションとして数えられ、その Plugin が本来 opt-in であっても、 選択されたスロット用に強制的に有効化します。plugins.deny と plugins.entries.<id>.enabled: false は引き続きそれをブロックします。
• バンドル済み opt-in Plugin は、設定がその所有サーフェスのいずれかを指定した場合に自動アクティベートできます。 たとえば、provider/model ref、チャネル設定、CLI バックエンド、またはエージェントハーネスランタイムです。
• OpenAI ファミリーの Codex ルーティングは、プロバイダーとランタイム Plugin の境界を分離したままにします。 レガシー Codex model ref は doctor が修復するレガシー設定であり、バンドル済み codex Plugin は、 正規の openai/* agent ref、明示的な agentRuntime.id: "codex"、および レガシー codex/* ref 用の Codex app-server ランタイムを所有します。

​

Plugin 形式を理解する

​

Plugin フック

• ランタイムライフサイクルイベント用の api.on(...) 型付きフック。これは、 ミドルウェア、ポリシー、メッセージ書き換え、プロンプト整形、ツール制御に推奨されるサーフェスです。
• フックで説明されている内部フックシステム用の api.registerHook(...)。 これは主に、大まかなコマンド/ライフサイクルの副作用と、既存の HOOK スタイル自動化との互換性のためのものです。

​

アクティブな Gateway を確認する

openclaw gateway status --deep --require-rpc
openclaw plugins inspect <plugin-id> --runtime --json
openclaw gateway restart

​

トラブルシューティング

​

ブロックされた plugin パス所有権

sudo chown -R 1000:1000 /path/to/openclaw-config /path/to/openclaw-workspace

sudo chown -R root:root /path/to/openclaw-config/npm

​

遅い plugin ツールセットアップ

openclaw config set logging.level trace
openclaw logs --follow

[trace:plugin-tools] factory timings ...

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

​

関連

• Manage plugins - list、install、update、uninstall、publish のコマンド例
• openclaw plugins - 完全な CLI リファレンス
• Plugin inventory - 生成された bundled および external plugin 一覧
• Plugin reference - 生成された plugin ごとのリファレンスページ
• Community plugins - ClawHub discovery と docs PR policy
• Plugin dependency resolution - install roots、registry records、runtime boundaries
• Building plugins - native plugin authoring guide
• Plugin SDK overview - runtime registration、hooks、API fields
• Plugin manifest - manifest と package metadata