@serpapi/openclaw-plugin

SerpApi search plugin for OpenClaw. Registers a web_search provider plus specialized SerpApi tools, distributed through ClawHub.

This is the ClawHub/external-plugin distribution of the SerpApi integration. It replaces the earlier attempt to bundle SerpApi into OpenClaw core (openclaw/openclaw#86440), which was closed with the guidance that optional, credentialed third-party providers should ship as installable ClawHub plugins rather than core code.

What it provides

• web_search provider — "SerpApi Search", backed by SerpApi's Google Light engine (fastest Google Search API).

Specialized SerpApi verticals (news, flights, maps, shopping, scholar, finance, YouTube, hotels, events, e-commerce, etc.) follow the same tool pattern and are added as dedicated tools in subsequent releases, delivered through pull requests.

Install

openclaw plugins install clawhub:@serpapi/openclaw-plugin

Or via npm during launch cutover:

openclaw plugins install npm:@serpapi/openclaw-plugin

Configure

Set the API key via config or the SERPAPI_API_KEY environment variable:

{
  plugins: {
    entries: {
      serpapi: {
        enabled: true,
        config: { webSearch: { apiKey: "YOUR_SERPAPI_KEY", hl: "en" } },
      },
    },
  },
}

export SERPAPI_API_KEY="YOUR_SERPAPI_KEY"

Get a key at serpapi.com/users/sign_up.

Develop

Requires Node 22.19+ and pnpm.

pnpm install
pnpm run typecheck
pnpm run build

The plugin targets openclaw >= 2026.6.11 and imports the plugin SDK from the openclaw/plugin-sdk/* subpaths.

Publish to ClawHub

pnpm run build
clawhub package validate .
clawhub package publish . --family code-plugin --dry-run
clawhub package publish . --family code-plugin

License

MIT