web-search-plus-plugin 1.1.4

package/.env.template

@@ -0,0 +1,4 @@
+SERPER_API_KEY=your-serper-key-here
+TAVILY_API_KEY=your-tavily-key-here
+EXA_API_KEY=your-exa-key-here
+PERPLEXITY_API_KEY=your-perplexity-key-here

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 robbyczgw-cla
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,82 @@
+# web-search-plus-plugin — OpenClaw Plugin
+
+A standalone OpenClaw plugin that exposes `web_search_plus` as a native tool with multi-provider routing.
+
+It bundles its own Python backend script and supports:
+- **Serper (Google)** — best for factual/shopping queries
+- **Tavily** — best for research & analysis
+- **Exa (Neural)** — best for discovery & semantic search
+- **Perplexity** — AI-synthesized answers with citations
+- **You.com** — real-time web + RAG
+- **SearXNG** — self-hosted privacy-first search
+
+The tool auto-routes queries by intent or you can force a specific provider.
+
+## What it does
+
+- Registers native tool: `web_search_plus`
+- Runs bundled script at `scripts/search.py`
+- Supports:
+  - `query` (required)
+  - `provider` (`serper` | `tavily` | `exa` | `perplexity` | `you` | `searxng` | `auto`)
+  - `count` (result count)
+
+## Installation
+
+Add plugin path to `plugins.load.paths` and enable in `plugins.entries`.
+
+### Example OpenClaw config snippet
+
+```json
+{
+  "plugins": {
+    "load": {
+      "paths": [
+        "/path/to/web-search-plus-plugin"
+      ]
+    },
+    "entries": [
+      {
+        "id": "web-search-plus-plugin",
+        "enabled": true
+      }
+    ]
+  }
+}
+```
+
+## Environment variables
+
+Copy `.env.template` to `.env` and add your API keys.
+
+At least one provider key is required:
+- `SERPER_API_KEY` — [console.serper.dev](https://console.serper.dev)
+- `TAVILY_API_KEY` — [tavily.com](https://tavily.com)
+- `EXA_API_KEY` — [exa.ai](https://exa.ai)
+- `KILOCODE_API_KEY` or `PERPLEXITY_API_KEY` — [perplexity.ai](https://docs.perplexity.ai) (optional, also works via [Kilo Gateway](https://kilocode.ai))
+- `YOU_API_KEY` — [you.com/api](https://you.com/api) (optional)
+- `SEARXNG_URL` — your SearXNG instance URL (optional, self-hosted)
+
+## Enable for an agent
+
+Allow the tool in agent config:
+
+```json
+{
+  "agents": {
+    "my-agent": {
+      "tools": {
+        "allow": [
+          "web_search_plus"
+        ]
+      }
+    }
+  }
+}
+```
+
+## Notes
+
+- Plugin resolves the script path relative to the plugin directory.
+- No dependency on external skill paths.
+- Publishable as a standalone plugin repository.

package/index.ts

@@ -0,0 +1,129 @@
+import { Type } from "@sinclair/typebox";
+import { spawnSync } from "child_process";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+function getPluginDir(): string {
+  try {
+    if (typeof __dirname !== "undefined") return __dirname;
+  } catch {}
+  try {
+    return path.dirname(fileURLToPath(import.meta.url));
+  } catch {}
+  return path.join(process.cwd(), "skills", "web-search-plus-plugin");
+}
+
+function loadEnvFile(envPath: string): Record<string, string> {
+  if (!fs.existsSync(envPath)) return {};
+  const env: Record<string, string> = {};
+  const lines = fs.readFileSync(envPath, "utf8").split("\n");
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const stripped = trimmed.startsWith("export ") ? trimmed.slice(7) : trimmed;
+    const eqIdx = stripped.indexOf("=");
+    if (eqIdx < 0) continue;
+    const key = stripped.slice(0, eqIdx).trim();
+    const val = stripped.slice(eqIdx + 1).trim().replace(/^['"]|['"]$/g, "");
+    if (key) env[key] = val;
+  }
+  return env;
+}
+
+const PLUGIN_DIR = getPluginDir();
+const scriptPath = path.join(PLUGIN_DIR, "scripts", "search.py");
+
+export default function (api: any) {
+  api.registerTool(
+    {
+      name: "web_search_plus",
+      description:
+        "Search the web using multi-provider routing (Serper/Google, Tavily/Research, Exa/Neural). Automatically routes to the best provider based on query intent. Use this for ALL web searches instead of web_search.",
+      parameters: Type.Object({
+        query: Type.String({ description: "Search query" }),
+        provider: Type.Optional(
+          Type.Union(
+            [
+              Type.Literal("serper"),
+              Type.Literal("tavily"),
+              Type.Literal("exa"),
+              Type.Literal("auto"),
+            ],
+            {
+              description:
+                "Force a specific provider, or 'auto' for smart routing (default: auto)",
+            },
+          ),
+        ),
+        count: Type.Optional(
+          Type.Number({ description: "Number of results (default: 5)" }),
+        ),
+      }),
+      async execute(
+        _id: string,
+        params: { query: string; provider?: string; count?: number },
+      ) {
+        const args = [scriptPath, "--query", params.query, "--compact"];
+
+        if (params.provider && params.provider !== "auto") {
+          args.push("--provider", params.provider);
+        }
+
+        if (typeof params.count === "number" && Number.isFinite(params.count)) {
+          args.push("--max-results", String(Math.max(1, Math.floor(params.count))));
+        }
+
+        const envPaths = [
+          path.join(PLUGIN_DIR, ".env"),
+          path.join(PLUGIN_DIR, "..", "web-search-plus", ".env"),
+        ];
+        const fileEnv: Record<string, string> = {};
+        for (const envPath of envPaths) {
+          Object.assign(fileEnv, loadEnvFile(envPath));
+        }
+        const childEnv = { ...process.env, ...fileEnv };
+
+        try {
+          const child = spawnSync("python3", args, {
+            timeout: 30000,
+            env: childEnv,
+            shell: false,
+            encoding: "utf8",
+          });
+
+          if (child.error) {
+            return {
+              content: [
+                { type: "text", text: `Search failed: ${child.error.message}` },
+              ],
+            };
+          }
+
+          if (child.status !== 0) {
+            const stderr = child.stderr?.trim() || "Unknown error";
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: `Search failed (exit ${child.status}): ${stderr}`,
+                },
+              ],
+            };
+          }
+
+          return {
+            content: [{ type: "text", text: child.stdout?.trim() || "{}" }],
+          };
+        } catch (err: any) {
+          return {
+            content: [
+              { type: "text", text: `Search failed: ${err?.message ?? err}` },
+            ],
+          };
+        }
+      },
+    },
+    { optional: true },
+  );
+}

package/openclaw.plugin.json

@@ -0,0 +1,11 @@
+{
+  "id": "web-search-plus-plugin",
+  "name": "Web Search Plus",
+  "version": "1.0.0",
+  "description": "Multi-provider web search (Serper/Tavily/Exa) as native tool",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "web-search-plus-plugin",
+  "version": "1.1.4",
+  "description": "OpenClaw plugin: multi-provider web search (Serper/Google, Tavily, Exa, Perplexity) as native tool",
+  "type": "module",
+  "main": "index.ts",
+  "files": [
+    "index.ts",
+    "openclaw.plugin.json",
+    "scripts/",
+    ".env.template",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": ["openclaw", "plugin", "search", "serper", "tavily", "exa", "perplexity", "web-search"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/robbyczgw-cla/web-search-plus-plugin"
+  },
+  "author": "robbyczgw-cla",
+  "license": "MIT"
+}