إنشاء Plugins

openclaw plugins install clawhub:<package-name>

​

المتطلبات

• Node 22.22.3+، أو Node 24.15+، أو Node 25.9+، وnpm أو pnpm.
• وحدات TypeScript ESM.
• للعمل على Plugin مضمّن داخل المستودع، استنسخ المستودع وشغّل pnpm install. يقتصر تطوير Plugins من نسخة المصدر على pnpm لأن OpenClaw يكتشف Plugins المضمّنة من حزم مساحة العمل extensions/*.

​

اختيار بنية 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() }),
      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 every tool 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";

​

قائمة التحقق قبل الإرسال

​

الاختبار مقابل الإصدارات التجريبية

1. راقب إصدارات openclaw/openclaw (Watch > Releases). تبدو وسوم الإصدار التجريبي مثل v2026.3.N-beta.1. يمكنك أيضًا متابعة @openclaw على X للاطلاع على إعلانات الإصدارات.
2. اختبر Plugin الخاص بك باستخدام وسم الإصدار التجريبي فور ظهوره. عادةً لا تتجاوز الفترة السابقة للإصدار المستقر بضع ساعات.
3. انشر في سلسلة Plugin الخاص بك ضمن قناة Discord ‏plugin-forum (discord.gg/clawd) بعد الاختبار، مع ذكر إما all good أو ما تعطل. أنشئ سلسلة إذا لم تكن لديك واحدة بعد.
4. إذا تعطل شيء ما، فافتح مشكلة أو حدّث مشكلة بعنوان Beta blocker: <plugin-name> - <summary> وطبّق التصنيف beta-blocker. أدرج رابط المشكلة في سلسلتك.
5. افتح PR إلى main بعنوان fix(<plugin-id>): beta blocker - <summary>، وأدرج رابط المشكلة في كلٍ من PR وسلسلة Discord الخاصة بك. لا يمكن للمساهمين وضع تصنيفات على طلبات PR، لذا يُعد العنوان إشارة طلب PR للمشرفين وعمليات الأتمتة. تُدمج العوائق التي لها PR؛ أما العوائق التي ليس لها PR فقد تُضمَّن في الإصدار رغم ذلك.
6. الصمت يعني أن كل شيء سليم. عادةً ما يعني تفويت هذه الفترة أن إصلاحك سيُدمج في الدورة التالية.

​

الخطوات التالية

​

ذو صلة

• خطافات Plugin
• بنية Plugin