openclaw/extensions/webhooks/index.ts

import { definePluginEntry, type OpenClawPluginApi } from "./api.js";
import { resolveWebhooksPluginConfig } from "./src/config.js";
import { createTaskFlowWebhookRequestHandler, type TaskFlowWebhookTarget } from "./src/http.js";

export default definePluginEntry({
  id: "webhooks",
  name: "Webhooks",
  description:
    "Authenticated inbound webhooks that bind external automation to OpenClaw TaskFlows.",
  async register(api: OpenClawPluginApi) {
    const routes = await resolveWebhooksPluginConfig({
      pluginConfig: api.pluginConfig,
      cfg: api.config,
      env: process.env,
      logger: api.logger,
    });
    if (routes.length === 0) {
      return;
    }

    const targetsByPath = new Map<string, TaskFlowWebhookTarget[]>();
    const handler = createTaskFlowWebhookRequestHandler({
      cfg: api.config,
      targetsByPath,
    });

    for (const route of routes) {
      const taskFlow = api.runtime.taskFlow.bindSession({
        sessionKey: route.sessionKey,
      });
      const target: TaskFlowWebhookTarget = {
        routeId: route.routeId,
        path: route.path,
        secret: route.secret,
        defaultControllerId: route.controllerId,
        taskFlow,
      };
      targetsByPath.set(target.path, [...(targetsByPath.get(target.path) ?? []), target]);
      api.registerHttpRoute({
        path: target.path,
        auth: "plugin",
        match: "exact",
        replaceExisting: true,
        handler,
      });
      api.logger.info?.(
        `[webhooks] registered route ${route.routeId} on ${route.path} for session ${route.sessionKey}`,
      );
    }
  },
});