OpenClaw, the self-hosted AI assistant that integrates with your existing chat apps, has long required a search provider with an API key to enable web search. A new plugin, @agentsearchhq/openclaw-web-search, removes that barrier by offering free web search without any signup, API key, or wallet. The plugin, tested against OpenClaw 2026.11.5 and plugin version 0.1.0, provides up to 25 searches per day per IP address, making it a zero-friction entry point for users wanting live web access for their local AI agents.
Installation and Configuration
Since the plugin is not yet on ClawHub, users must install it directly from npm using the command openclaw plugins install npm:@agentsearchhq/openclaw-web-search. OpenClaw will prompt for confirmation due to the source being outside its official review hub. After installation, users must explicitly select AgentSearch as the provider via openclaw config set tools.web.search.provider agentsearch, as the system does not auto-select key-free providers. A gateway restart is required to load the new plugin.
Cost Model and Limits
The free tier allows 25 searches per day per IP, returning up to 5 ranked results with titles, URLs, snippets, and publish dates. For users exceeding this limit, the plugin supports a pay-per-use model via x402, costing $0.003 per search in USDC on the Base network. This paid mode requires a small wallet, with no account signup needed, and includes a default spending cap of $1.00 per gateway process. The plugin ensures no charges for errors or empty result sets, and the private key for payments is never logged.
Advanced Features and Troubleshooting
Beyond basic search, users can add the AgentSearch MCP server to enable page extraction and rendering, with free trials for those functions as well. Paid search unlocks additional filters like freshness, date range, country, and language. Common troubleshooting steps include ensuring the provider is correctly selected in the config and checking the gateway logs for the current search mode, which will indicate whether free or paid limits are in effect.
Key Takeaways
- Free tier offers 25 searches/day per IP with no API key or signup.
- Paid tier costs $0.003/search via USDC on Base, using x402 protocol.
- Plugin is installed via npm, not yet available on ClawHub.
- Users must manually set the provider in config after installation.
- No charges for failed searches or empty results in paid mode.
The Bottom Line
This plugin is a massive win for the self-hosted AI community, eliminating the friction of API keys for basic web access. It aligns perfectly with OpenClaw's decentralized ethos, though users should monitor their spending caps when opting for the paid tier.