Створення Pluginів

openclaw plugins install clawhub:<package-name>

​

Вимоги

• Використовуйте Node 22.19+, Node 23.11+ або Node 24+ і менеджер пакетів, наприклад npm або pnpm.
• Знайтеся на TypeScript ESM-модулях.
• Для роботи з вбудованим у репозиторій плагіном клонуйте репозиторій і виконайте pnpm install. Розробка плагінів із вихідного checkout підтримує лише pnpm, оскільки OpenClaw завантажує вбудовані плагіни з пакетів робочого простору extensions/*.

​

Виберіть форму плагіна

​

Швидкий старт

{
  "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() }),
      async execute(_id, params) {
        return {
          content: [{ type: "text", text: `Got: ${params.input}` }],
        };
      },
    });
  },
});

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() }),
      async execute(_id, params) {
        return { content: [{ type: "text", text: params.pipeline }] };
      },
    },
    { optional: true },
  );
}

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

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

​

Угоди щодо імпортів

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

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

​

Контрольний список перед поданням

​

Тестування з beta-релізами

1. Стежте за тегами релізів GitHub у openclaw/openclaw і підпишіться через Watch > Releases. Бета-теги мають вигляд v2026.3.N-beta.1. Також можна ввімкнути сповіщення для офіційного акаунта OpenClaw в X @openclaw, щоб отримувати оголошення про релізи.
2. Протестуйте свій plugin із бета-тегом, щойно він з’явиться. Вікно перед стабільним релізом зазвичай триває лише кілька годин.
3. Після тестування напишіть у гілці свого plugin у каналі Discord plugin-forum: або all good, або що саме зламалося. Якщо у вас ще немає гілки, створіть її.
4. Якщо щось зламається, відкрийте або оновіть issue з назвою Beta blocker: <plugin-name> - <summary> і застосуйте мітку beta-blocker. Додайте посилання на issue у свою гілку.
5. Відкрийте PR до main з назвою fix(<plugin-id>): beta blocker - <summary> і додайте посилання на issue як у PR, так і у свою гілку Discord. Учасники не можуть додавати мітки до PR, тому назва є сигналом на боці PR для мейнтейнерів і автоматизації. Блокери з PR об’єднують; блокери без PR можуть потрапити в реліз попри це. Мейнтейнері стежать за цими гілками під час бета-тестування.
6. Мовчання означає зелений статус. Якщо ви пропустите вікно, ваш fix, імовірно, потрапить у наступний цикл.

​

Наступні кроки

​

Пов’язане

• Хуки Plugin
• Архітектура Plugin