Edge-runtime plugin gateway for the openclawd ecosystem.

Fetches the plugin index from plugin.delivery, validates requests against each plugin's manifest + JSON schema, forwards to the plugin runtime, and streams the response back through the CLAWD permission engine.

English · 简体中文 ·

🏠 Ecosystem · 💻 Terminal · 🎨 Studio · 💱 DEX · 📲 Telegram · 📱 Mobile

TOC

• 👋 Intro
• 🤯 Usage
  • Base URLs
  • POST Plugin Gateway
• 🛳 Self Hosting
  • Deploy to Vercel
• 📦 Plugin Ecosystem
• ⌨️ Local Development
• 🤝 Contributing
• 🔗 Links

👋 Intro

The gateway is the execution bridge between a CLAWD agent and a plugin listed in plugin.delivery. Agents never call plugin URLs directly — the gateway:

1. Resolves the plugin manifest by identifier from the index
2. Validates arguments against the plugin's JSON schema (AJV or @cfworker/json-schema)
3. Applies deny-first permission gating (trades, signatures, wallet spends, CLAWD burns)
4. Forwards the request to the plugin's OpenAPI endpoint via swagger-client
5. Returns a structured GatewaySuccessResponse | GatewayErrorResponse to the agent

We ship it as a Vercel Edge Function (POST /api/v1/runner) and a node variant for local daemons.

To add a plugin to the index, submit a PR to the openclawd repo.

![][back-to-top]

🤯 Usage

Base URLs

| Environment | URL | | ----------- | ---------------------------------------------- | | PROD | https://plugin.delivery | | DEV | https://plugin.delivery |

POST Plugin Gateway

Note
POST /api/v1/runner
Interface to communicate with the OpenClawd plugin. This interface describes how to use the OpenClawd plugin gateway API to send requests and get responses

Body Request Parameters

{
  "arguments": "{\n  \"city\": \"杭州\"\n}",
  "name": "realtimeWeather"
}

Response

[
  {
    "city": "杭州市",
    "adcode": "330100",
    "province": "浙江",
    "reporttime": "2023-08-17 23:32:22",
    "casts": [
      {
        "date": "2023-08-17",
        "week": "4",
        "dayweather": "小雨",
        "nightweather": "小雨",
        "daytemp": "33",
        "nighttemp": "24",
        "daywind": "东",
        "nightwind": "东",
        "daypower": "≤3",
        "nightpower": "≤3",
        "daytemp_float": "33.0",
        "nighttemp_float": "24.0"
      },
      {
        "date": "2023-08-18",
        "week": "5",
        "dayweather": "小雨",
        "nightweather": "小雨",
        "daytemp": "32",
        "nighttemp": "23",
        "daywind": "东北",
        "nightwind": "东北",
        "daypower": "4",
        "nightpower": "4",
        "daytemp_float": "32.0",
        "nighttemp_float": "23.0"
      },
      {
        "date": "2023-08-19",
        "week": "6",
        "dayweather": "小雨",
        "nightweather": "雷阵雨",
        "daytemp": "32",
        "nighttemp": "24",
        "daywind": "东",
        "nightwind": "东",
        "daypower": "4",
        "nightpower": "4",
        "daytemp_float": "32.0",
        "nighttemp_float": "24.0"
      },
      {
        "date": "2023-08-20",
        "week": "7",
        "dayweather": "雷阵雨",
        "nightweather": "多云",
        "daytemp": "33",
        "nighttemp": "25",
        "daywind": "东",
        "nightwind": "东",
        "daypower": "≤3",
        "nightpower": "≤3",
        "daytemp_float": "33.0",
        "nighttemp_float": "25.0"
      }
    ]
  }
]

See API Document for more information.

![][back-to-top]

🛳 Self Hosting

If you want to deploy this service by yourself, you can follow the steps below.

Deploy to Vercel

Click button below to deploy your private plugins' gateway.

If you want to make some customization, you can add environment variable:

• PLUGINS_INDEX_URL: You can change the default plugins index url as your need.

![][back-to-top]

📦 Plugin Ecosystem

Plugins provide a means to extend the Function Calling capabilities of OpenClawd. They can be used to introduce new function calls and even new ways to render message results. If you are interested in plugin development, please refer to our 📘 Plugin Development Guide in the Wiki.

• [openclawd-plugins][openclawd-plugins]: This is the plugin index for OpenClawd. It accesses index.json from this repository to display a list of available plugins for OpenClawd to the user.
• [chat-plugin-template][chat-plugin-template]: This is the plugin template for OpenClawd plugin development.
• [@openclawdsolana/plugin-sdk][chat-plugin-sdk]: The OpenClawd Plugin SDK assists you in creating exceptional chat plugins for OpenClawd.
• [@openclawdsolana/chat-plugins-gateway][chat-plugins-gateway]: The OpenClawd Plugins Gateway is a backend service that provides a gateway for OpenClawd plugins. We deploy this service using Vercel. The primary API POST /api/v1/runner is deployed as an Edge Function.

![][back-to-top]

⌨️ Local Development

You can use Github Codespaces for online development:

[![][github-codespace-shield]][github-codespace-link]

Or clone it for local development:

[![][bun-shield]][bun-link]

$ git clone https://github.com/clawdsolana/OpenClawd
$ cd chat-plugins-gateway
$ bun install
$ bun dev

![][back-to-top]

![][back-to-top]

🔗 Links

• 🤖 openclawd - An open-source, extensible (Function Calling), high-performance chatbot framework. It supports one-click free deployment of your private ChatGPT/LLM web application.
• Plugin Delivery - This is the plugin index. It accesses index.json from this repository to display a list of available plugins for Function Calling to the user.

![][back-to-top]

📝 License

Copyright © 2026 [Plugin.Delivery][profile-link]. This project is MIT licensed.