Introducing SerpApi’s OpenClaw Agent Plugin

SerpApi released an open-source plugin for OpenClaw, the self-hosted open-source personal AI assistant, connecting OpenClaw's built-in web_search to SerpApi and adding 30 specialized tools for news, maps, shopping, flights, and more. The plugin, available now on ClawHub, registers a first-class web_search provider through OpenClaw's plugin SDK with no separate MCP server or sidecar process, and authenticates all tools with a single SERPAPI_API_KEY. Google Light is the default backend for general web search because its compact response and low latency suit agent workflows.

OpenClaw is a open-source personal AI assistant, self-hosted and extensible. It can connect to connect to services like email, calendars, messaging apps, web search, and other tools to automate workflows. You can run it on your machine, wire in local or hosted models, and add third-party tools. More information can be found here https://openclaw.ai/ https://openclaw.ai/ and also check available integrations https://clawhub.ai/ https://clawhub.ai/ . Today, we are releasing the open-source SerpApi plugin for OpenClaw. It connects OpenClaw’s built-in web search to SerpApi and adds dedicated tools for news, maps, shopping, flights, and more. The plugin is available now on ClawHub https://clawhub.ai/serpapi/plugins/openclaw-plugin . What the Plugin Adds OpenClaw already knows when it needs to search the web. The plugin gives it a SerpApi-backed search stack to choose from: | What you ask for | OpenClaw tool | |---|---| | General web research | web search provider | | Results from Bing, DuckDuckGo, and Yahoo | serpapi bing , serpapi duckduckgo , serpapi yahoo | | Query ideas and suggestions | serpapi autocomplete | | Current and recent news | serpapi news | | Academic papers and citations | serpapi scholar | | Places and local businesses | serpapi maps | | Reviews for a specific place | serpapi maps reviews | | Restaurants, attractions, and destinations on Tripadvisor | serpapi tripadvisor | | Concerts and local events | serpapi events | | Weather forecasts | serpapi weather | | Flights and fares | serpapi flights | | Hotels and vacation rentals | serpapi hotels | | Products, prices, and merchants on Google Shopping | serpapi shopping , serpapi immersive product | | Amazon listings and product details | serpapi amazon , serpapi amazon product | | Walmart listings and product details | serpapi walmart , serpapi walmart product | | eBay listings, auctions, and used items | serpapi ebay , serpapi ebay product | | Visually similar products and image sources | serpapi lens | | Job listings | serpapi jobs | | Stocks, crypto, and exchange rates | serpapi finance | | Search interest over time and by region | serpapi trends | | YouTube videos and channels | serpapi youtube | | YouTube video details and transcripts | serpapi youtube video , serpapi youtube transcript | | Public Facebook and Instagram profiles | serpapi facebook profile , serpapi instagram profile | Many tools work in pairs: a search tool finds candidates, and a detail tool Amazon product, map reviews, YouTube transcript digs into the one that matters. For a normal web query, OpenClaw continues to use its familiar web search path; the plugin supplies the SerpApi as backend. For a local, news, shopping, or domain-specific request, OpenClaw can call the matching specialized tool. You can ask naturally without remembering an engine name or tool name. Google Light is the default for general web search because its compact response and low latency are a good fit for agent workflows. The specialized tools keep the useful structured fields from their respective engines-addresses and ratings for places, publishers and dates for news, prices and merchants for products, and so on. Beyond the core set above, the plugin ships 30 specialized tools covering Google Scholar, Flights, Hotels, Events, Jobs, Trends, Finance, Lens, Autocomplete, Bing, DuckDuckGo, Yahoo, YouTube search, video, transcript , Amazon, eBay, Walmart, Google Immersive Product, Tripadvisor, Weather, and public Facebook/Instagram profiles. Key Features - Native OpenClaw integration. The package uses OpenClaw’s plugin SDK and registers a first-class web search provider. There is no separate MCP server or sidecar process to run. - Natural tool selection. OpenClaw chooses general web search or a specialized SerpApi tool from the user’s request. - One API key. SERPAPI API KEY authenticates every search path in the plugin. - Focused responses. Each search path returns the fields the agent needs instead of passing an entire raw search response into context. - ClawHub distribution. Install with one command; updates and version history live on ClawHub. Getting Started You need a working OpenClaw installation and a SerpApi account. If you are new to OpenClaw, follow its installation guide https://docs.openclaw.ai/ first. Install the plugin openclaw plugins install clawhub:@serpapi/openclaw-plugin Restart the gateway so OpenClaw loads the plugin: openclaw gateway restart Configure your API key Set the key via environment variable: create a free account https://serpapi.com/users/sign up and get 250 credits each month. After signing up, you’ll find your API key in the Dashboard https://serpapi.com/dashboard . export SERPAPI API KEY="YOUR SERPAPI KEY" Or add it to ~/.openclaw/openclaw.json : { plugins: { entries: { serpapi: { enabled: true, config: { webSearch: { apiKey: "YOUR SERPAPI KEY", hl: "en", }, }, }, }, }, tools: { web: { search: { provider: "serpapi", enabled: true, }, }, }, } Verify the plugin is loaded: openclaw plugins list Run OpenClaw with Docker for the paranoid I added this section for anyone who wants to experiment with OpenClaw without installing it locally or giving it full access to their computer. You can run OpenClaw in a container and install the plugin there. This keeps its state in a local volume and passes your SerpApi key through environment variables. Prerequisites - Docker https://docs.docker.com/desktop/ - A SerpApi API key from serpapi.com https://serpapi.com/users/sign up - Optional Ollama https://ollama.com/download - run local models for free instead of paid cloud APIs. Here is simple docker-compose.yml to run openclaw service. services: openclaw: image: ghcr.io/openclaw/openclaw:2026.9.7 container name: openclaw ports: - "127.0.0.1:18789:18789" environment: - NODE ENV=production - OLLAMA API KEY=ollama-local - OLLAMA HOST=http://host.docker.internal:11434 - SERPAPI API KEY=${SERPAPI KEY:-} - OPENCLAW PLUGIN DIR=/workspace/plugins - OPENCLAW GATEWAY TOKEN=${OPENCLAW GATEWAY TOKEN:-} volumes: - ./openclaw-home:/home/node/.openclaw security opt: - no-new-privileges:true extra hosts: - "host.docker.internal:host-gateway" stdin open: true tty: true We'll create .env file in the repo root to store environment variables and configuration values needed to run the project locally. Now let's generate token for OpenClaw Gateway: openssl rand -hex 32 Paste the output into the .env file in the repo root. It should look something like this: create a free account https://serpapi.com/users/sign up and get 250 credits each month. After signing up, you’ll find your API key in the Dashboard https://serpapi.com/dashboard . Now we are ready to the first start OpenClaw docker container: docker compose run --rm openclaw openclaw setup --baseline --non-interactive --accept-risk docker compose up -d With a token set, the OpenClaw's browser UI usually pairs automatically - no manual approve step needed. Open http://localhost:18789 http://localhost:18789 , approve the device pairing request if needed , then install the plugin inside the container: docker exec -it openclaw openclaw plugins install clawhub:@serpapi/openclaw-plugin docker exec -it openclaw openclaw config set tools.web.search.provider serpapi docker exec -it openclaw openclaw config set tools.web.search.enabled true --strict-json docker exec -it openclaw openclaw config set tools.alsoAllow ' "serpapi" ' docker compose restart OpenClaw state persists in ./openclaw-home/ on the host. Using open sources model optional To use OpenClaw with open sources models we are going to do it with Ollama. The docker-compose.yml file already points OpenClaw at Ollama on the host OLLAMA HOST=http://host.docker.internal:11434 . Install Ollama, pull a model, then wire it up with one command: download model ollama pull gemma4 tell openclaw to use ollama with gemma4 model docker exec -it openclaw openclaw onboard --non-interactive --accept-risk --skip-health \ --auth-choice ollama \ --custom-base-url "http://host.docker.internal:11434" \ --custom-model-id "gemma4:latest" docker port forwarding docker exec -it openclaw openclaw config set gateway.bind lan restart openclaw if already running docker compose restart Switch models anytime use a name from ollama list : docker exec -it openclaw openclaw models set ollama/gemma4:latest Verify: docker exec -it openclaw openclaw models status That’s it. OpenClaw is now running locally with Ollama, and everything is working together. Now you can open dashboard in your browser http://localhost:18789/ http://localhost:18789/n and start new chat session. Use and Test the Plugin in OpenClaw Use case 1: Compare product prices across stores. OpenClaw can turn that into several focused shopping searches, compare offers across Google Shopping, Amazon, Walmart, and eBay, separate the Standard, Digital, and Pro editions, then combine the results into a price comparison with store names, conditions, seller ratings, and direct links. Start with a prompt as short as: Find the best price for the Sony PlayStation 5 For a more repeatable briefing, give OpenClaw a little more direction: Find the best price for the Sony PlayStation 5. Check Google Shopping, Amazon, Walmart, and eBay separately, compare only new offers, and return a table sorted by price with store, condition, rating, and a link to each deal. This is where an agent-native search integration becomes useful: OpenClaw can run more than one query, refine its search as it learns, and organize the results around the task instead of returning a single page of links. Use case 2: Planning a trip A local search can be just as simple: Find cheap weekend trip from Warsaw, Poland In this case, OpenClaw ran a single general web search with no follow-up queries. The results were mixed: they included long-haul, expensive routes such as Chicago and Svalbard, which don't suit a cheap weekend. OpenClaw dropped them and pointed to options closer to home, like Kraków and the Gdańsk/Sopot coast, reachable by train, bus, or car. It added a few money-saving tips overnight trains, hostels, regional rail passes . Now let's ask more specific question: Compare at least 5 destinations, pick the cheapest Fri–Sun flights, add a well-rated hotel under €150/night, and return total cost per trip with booking links. As we can see, OpenClaw now uses a wider range of tools to find hotels and flights. More prompt ideas Try these prompts for the remaining search paths: - Web+Finances: "Give me a quick brief on Nvidia before earnings." - News+Scholar: "Is it true that coffee reduces risk of Alzheimer's?" - Maps: "Find a restaurant in Kyiv for a team dinner of 4 people." - Jobs: "What remote Rust jobs are hiring right now?" - YouTube: "Find the best videos to learn Kubernetes from scratch." Together, these prompts work as quick smoke tests after installation. OpenClaw should use web search for general research and the dedicated SerpApi tools for their respective requests. Search results change over time, so verify the tool selected and the shape of the response rather than expecting the same listings on every run. 1. The plugin was installed and the gateway was restarted. 2. serpapi is enabled in openclaw plugins list . 3. SERPAPI API KEY is available to the OpenClaw process and SerpApi is selected as the web search provider. 4. Make sure all SerpApi tools are turned on in the plugin settings. How It Works The ClawHub package registers with OpenClaw at gateway startup. When OpenClaw discovers and enables the plugin, it: 1. Registers SerpApi as a web search provider backed by Google Light. 2. Registers specialized tools with schemas that describe their supported inputs. 3. Selects the corresponding SerpApi engine and validates the request. 4. Converts the API response into a compact, predictable result for the agent. This keeps the integration native to OpenClaw while preserving the structured search data that makes SerpApi useful for agent workflows. The plugin targets openclaw = 2026.6.11 and imports the plugin SDK from the openclaw/plugin-sdk/ subpaths. What's Next The SerpApi plugin for OpenClaw is available now on ClawHub https://clawhub.ai/serpapi/plugins/openclaw-plugin , and its source code is open on GitHub https://github.com/serpapi/serpapi-openclaw-plugin . If you find a bug or have an idea for another OpenClaw-native search capability, open an issue or pull request in the repository. If you have not tried SerpApi yet, create an account https://serpapi.com/users/sign up and give OpenClaw live search data in a few minutes. contact@serpapi.com or chat with us at https://serpapi.com https://serpapi.com .