Plugin 빌드하기

openclaw plugins install clawhub:<package-name>

​

요구 사항

• Node 22.19+, Node 23.11+ 또는 Node 24+와 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() }),
      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 규칙

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의 GitHub 릴리스 태그를 확인하고 Watch > Releases로 구독하세요. 베타 태그는 v2026.3.N-beta.1 형식입니다. 릴리스 공지를 받으려면 공식 OpenClaw X 계정 @openclaw의 알림도 켤 수 있습니다.
2. 베타 태그가 나타나는 즉시 해당 태그로 Plugin을 테스트하세요. 안정 버전 전까지의 기간은 보통 몇 시간에 불과합니다.
3. 테스트 후 plugin-forum Discord 채널에 있는 Plugin 스레드에 all good 또는 깨진 내용을 게시하세요. 아직 스레드가 없다면 새로 만드세요.
4. 문제가 생기면 Beta blocker: <plugin-name> - <summary> 제목의 이슈를 열거나 업데이트하고 beta-blocker 라벨을 적용하세요. 스레드에 이슈 링크를 넣으세요.
5. fix(<plugin-id>): beta blocker - <summary> 제목으로 main에 PR을 열고 PR과 Discord 스레드 모두에 이슈를 링크하세요. 기여자는 PR에 라벨을 붙일 수 없으므로, 제목이 유지 관리자와 자동화를 위한 PR 측 신호입니다. PR이 있는 차단 문제는 병합되지만, PR이 없는 차단 문제는 그대로 릴리스될 수도 있습니다. 유지 관리자는 베타 테스트 중 이 스레드들을 확인합니다.
6. 무응답은 문제가 없다는 뜻입니다. 기간을 놓치면 수정 사항은 다음 주기에 반영될 가능성이 높습니다.

​

다음 단계

​

관련 항목

• Plugin 훅
• Plugin 아키텍처