@alfe.ai/openclaw-search
v0.0.45
Published
OpenClaw search plugin — web, image, and news search
Readme
@alfe.ai/openclaw-search
OpenClaw plugin for Alfe-managed web, image, and news search. It routes requests through the agent-authenticated Alfe Search service, so provider credentials and metering remain server-side.
Current OpenClaw runtimes use the plugin as the alfe provider for the builtin
web_search tool. Older runtimes receive a legacy web_search plugin tool.
image_search and news_search are registered directly on every runtime.
Runtime boundary
- Tool and provider registration happens on every activation.
- Alfe config and the HTTP client resolve lazily, so a transient config read cannot remove tools from the catalog.
- Queries are 1–400 non-control characters; result count is 1–20; web/news page offset is 0–9.
- Raw Brave payloads are projected into a stable bounded shape. Unknown fields, credential-bearing/invalid URLs, excess results, and provider-only metadata are not passed to the model.
- Search result text is explicitly marked as untrusted external content.
- Unexpected provider/API failures are redacted. The modern web provider also forwards OpenClaw cancellation into the Agent API request.
OpenClaw's provider contract is documented in its official
web-provider-types.ts.
Development
pnpm --filter @alfe.ai/openclaw-search lint
pnpm --filter @alfe.ai/openclaw-search typecheck
pnpm --filter @alfe.ai/openclaw-search test
pnpm --filter @alfe.ai/openclaw-search buildSee DEVELOPING.md for invariants and the decision record.
