Плагины (SDK)

Система плагинов OpenClaw позволяет расширять функциональность: добавлять каналы, провайдеры моделей, инструменты, голос и многое другое. Плагины — это npm-пакеты, которые не нужно добавлять в репозиторий OpenClaw. Публикуйте в ClawHub или npm, пользователи устанавливают одной командой.

Что можно сделать с плагином

Быстрый старт: создание tool-плагина

1. package.json + манифест

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

{
  "id": "my-plugin",
  "name": "My Plugin",
  "description": "Adds a custom tool to OpenClaw",
  "configSchema": {
    "type": "object",
    "additionalProperties": false
  }
}

Манифест нужен всегда, даже без конфига.

2. Точка входа (index.ts)

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

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

Для каналов — defineChannelPluginEntry. Для провайдеров — defineSingleProviderPluginEntry.

3. Тестирование и публикация

# Тест (dry-run)
clawhub package publish your-org/your-plugin --dry-run
# Публикация
clawhub package publish your-org/your-plugin
# Установка
openclaw plugins install clawhub:@myorg/openclaw-my-plugin

OpenClaw проверяет ClawHub перед npm. Bare package specs тоже работают.

Обязательные и опциональные инструменты

register(api) {
  // Обязательный — всегда доступен
  api.registerTool({
    name: "my_tool",
    description: "Always available",
    parameters: Type.Object({ input: Type.String() }),
    async execute(_id, params) {
      return { content: [{ type: "text", text: params.input }] };
    },
  });

  // Опциональный — пользователь должен включить в allowlist
  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 },
  );
}

Пользователи включают опциональные инструменты:

{
  "tools": { "allow": ["workflow_tool"] }
}

Все инструменты плагина сразу: "tools": { "allow": ["my-plugin"] }.

Импорты

Всегда импортируйте из конкретных подпутей:

// ✅ Правильно
import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";

// ❌ Неправильно (deprecated)
import { ... } from "openclaw/plugin-sdk";

Внутри плагина — локальные barrel-файлы (api.ts, runtime-api.ts). Не импортируйте свой плагин через SDK-путь.

Plugin hooks

Хуки позволяют перехватывать события:

/approve обрабатывает exec и plugin approvals. Если exec approval id не найден — retry через plugin approvals.

Архитектура

Плагиновая система имеет 4 слоя:

Plugin shapes

Проверить: openclaw plugins inspect

Каналы и shared message tool

Каналам не нужно регистрировать отдельный send/edit/react tool. OpenClaw держит один общий message tool в core, а каналы владеют channel-specific discovery и execution.

Установка плагинов

openclaw plugins install 
openclaw plugins list
openclaw plugins inspect 
openclaw plugins doctor

OpenClaw проверяет ClawHub, потом npm. Если установка падает с package.json missing openclaw.extensions — плагин использует старый формат. Нужно добавить openclaw.extensions в package.json и указать на built файлы.

Чеклист перед публикацией

# Локальная директория
openclaw plugins install ./my-bundle

# Архив
openclaw plugins install ./my-bundle.tgz

# Claude marketplace
openclaw plugins marketplace list <marketplace-name>
openclaw plugins install <plugin-name>@<marketplace-name>

openclaw plugins list
openclaw plugins inspect <id>

openclaw gateway restart

Что дальше