Plugin の構築

openclaw plugins install clawhub:<package-name>

​

要件

• Node 22.22.3+、Node 24.15+、または Node 25.9+、および npm または pnpm。
• TypeScript ESM モジュール。
• リポジトリ内のバンドル済み Plugin を扱う場合は、リポジトリをクローンして pnpm install を実行します。 OpenClaw は extensions/* ワークスペースパッケージから バンドル済み Plugin を検出するため、ソースチェックアウトでの Plugin 開発では pnpm のみを使用できます。

​

Plugin の形態を選択する

​

クイックスタート

{
  "name": "@myorg/openclaw-my-plugin",
  "version": "1.0.0",
  "type": "module",
  "dependencies": {
    "typebox": "1.1.39"
  },
  "peerDependencies": {
    "openclaw": ">=2026.3.24-beta.2"
  },
  "openclaw": {
    "extensions": ["./index.ts"],
    "compat": {
      "pluginApi": ">=2026.3.24-beta.2",
      "minGatewayVersion": "2026.3.24-beta.2"
    },
    "build": {
      "openclawVersion": "2026.3.24-beta.2",
      "pluginSdkVersion": "2026.3.24-beta.2"
    }
  }
}

{
  "id": "my-plugin",
  "name": "My Plugin",
  "description": "Adds a custom tool to OpenClaw",
  "contracts": {
    "tools": ["my_tool"]
  },
  "activation": {
    "onStartup": true
  },
  "configSchema": {
    "type": "object",
    "additionalProperties": false
  }
}

import { Type } from "typebox";
import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";

export default definePluginEntry({
  id: "my-plugin",
  name: "My Plugin",
  description: "Adds a custom tool to OpenClaw",
  register(api) {
    api.registerTool({
      name: "my_tool",
      description: "Echo one input value",
      parameters: Type.Object({ input: Type.String() }),
      outputSchema: Type.Object(
        { input: Type.String() },
        { additionalProperties: false },
      ),
      async execute(_id, params) {
        const details = { input: params.input };
        return {
          content: [{ type: "text", text: `Got: ${params.input}` }],
          details,
        };
      },
    });
  },
});

openclaw plugins inspect my-plugin --runtime --json

pnpm test extensions/my-plugin/
pnpm check

npm pack --pack-destination /tmp
openclaw plugins install npm-pack:/tmp/<plugin-package>.tgz --force
openclaw plugins inspect my-plugin --runtime --json

clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin

openclaw plugins install clawhub:your-org/your-plugin

​

ツールの登録

register(api) {
  api.registerTool(
    {
      name: "workflow_tool",
      description: "Run a workflow",
      parameters: Type.Object({ pipeline: Type.String() }),
      outputSchema: Type.Object(
        { pipeline: Type.String() },
        { additionalProperties: false },
      ),
      async execute(_id, params) {
        return {
          content: [{ type: "text", text: params.pipeline }],
          details: { pipeline: params.pipeline },
        };
      },
    },
    { optional: true },
  );
}

{
  "contracts": {
    "tools": ["workflow_tool"]
  },
  "toolMetadata": {
    "workflow_tool": {
      "optional": true
    }
  }
}

{
  tools: { allow: ["workflow_tool"] }, // or ["my-plugin"] for every tool from one plugin
}

​

インポート規則

import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";

​

提出前チェックリスト

​

ベータリリースに対するテスト

1. openclaw/openclaw のリリース（Watch > Releases）をウォッチしてください。ベータタグは v2026.3.N-beta.1 のような形式です。リリースのお知らせについては、X で @openclaw をフォローすることもできます。
2. ベータタグが公開されたら、できるだけ早く Plugin をテストしてください。安定版までの猶予は通常、わずか数時間です。
3. テスト後、plugin-forum Discord チャンネル（discord.gg/clawd）にある Plugin のスレッドへ、all good または問題が発生した内容を投稿してください。スレッドがまだない場合は作成してください。
4. 問題が発生した場合は、Beta blocker: <plugin-name> - <summary> というタイトルの Issue を作成または更新し、beta-blocker ラベルを付けてください。スレッドに Issue へのリンクを記載してください。
5. main に、fix(<plugin-id>): beta blocker - <summary> というタイトルの PR を作成し、PR と Discord スレッドの両方に Issue へのリンクを記載してください。コントリビューターは PR にラベルを付けられないため、このタイトルがメンテナーと自動化システムに対する PR 側の合図になります。PR があるブロッカーはマージされますが、PR がないブロッカーがあってもそのままリリースされる可能性があります。
6. 連絡がなければ問題なしと見なされます。この期間を逃した場合、通常は修正が次のサイクルで取り込まれます。

​

次のステップ

​

関連項目

• Plugin フック
• Plugin アーキテクチャ