From 81a8c767c5025a8780385b23b0844d0fc43037be Mon Sep 17 00:00:00 2001
From: bogdanvelicu <bboodd24@gmail.com>
Date: Sun, 24 May 2026 17:53:22 +0300
Subject: [PATCH] fix(manifest): declare contracts, providers, and onStartup
 activation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

OpenClaw 2026.5.x's gateway-boot plugin loader requires plugins to
declare their capabilities upfront in openclaw.plugin.json. Without
these declarations, the loader skips the plugin at boot (CLI tools
like `openclaw plugins enable/inspect/doctor` are lenient and still
load it, masking the issue).

Symptoms on OpenClaw 2026.5.19+:
- `openclaw plugins inspect clawrouter` reports `Status: loaded`
- `openclaw plugins doctor` warns 26x:
  "plugin must declare contracts.tools before registering agent tools"
- After `openclaw gateway restart`, port 8402 is not listening
- /wallet, /stats, /blockrun, /partners commands are not registered
- BlockRun provider is not registered with the gateway

Fix: declare what the plugin actually provides:
- `activation.onStartup: true` so the plugin loads at gateway boot
  (it must run to serve the x402 proxy on :8402)
- `enabledByDefault: true` to opt into the trusted-by-default path
- `providers: ["blockrun"]` to declare the LLM provider
- `contracts.tools` listing all 26 partner tools the plugin registers
- `contracts.webSearchProviders: ["blockrun-exa"]` to declare the
  web-search provider

Verified on OpenClaw 2026.5.19 + ClawRouter 0.12.196: after this
patch, gateway boot logs show:
  [plugins] BlockRun provider registered (55+ models via x402)
  [plugins] Commands registered: /wallet, /blockrun, /stats, ...
  [plugins] BlockRun x402 proxy listening on port 8402
  [plugins] ClawRouter ready — smart routing enabled
  http server listening (13 plugins: ..., clawrouter, ...)

And /wallet works inside the OpenClaw TUI.
---
 openclaw.plugin.json | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/openclaw.plugin.json b/openclaw.plugin.json
index 4326de0..5886e51 100644
--- a/openclaw.plugin.json
+++ b/openclaw.plugin.json
@@ -3,6 +3,42 @@
   "name": "ClawRouter",
   "description": "Smart LLM router — 55+ models, x402 micropayments, 92% cost savings. Phone lookup + AI voice calls (Twilio + Bland.ai). Surf crypto-data API (84 endpoints, on-chain SQL, 100M+ labeled wallets) via skill.",
   "skills": ["./skills"],
+  "activation": {
+    "onStartup": true
+  },
+  "enabledByDefault": true,
+  "providers": ["blockrun"],
+  "contracts": {
+    "tools": [
+      "blockrun_predexon_events",
+      "blockrun_predexon_leaderboard",
+      "blockrun_predexon_markets",
+      "blockrun_predexon_smart_money",
+      "blockrun_predexon_smart_activity",
+      "blockrun_predexon_wallet",
+      "blockrun_predexon_wallet_pnl",
+      "blockrun_predexon_matching_markets",
+      "blockrun_predexon_endpoint_call",
+      "blockrun_stock_price",
+      "blockrun_stock_history",
+      "blockrun_stock_list",
+      "blockrun_crypto_price",
+      "blockrun_fx_price",
+      "blockrun_commodity_price",
+      "blockrun_image_generation",
+      "blockrun_image_edit",
+      "blockrun_video_generation",
+      "blockrun_phone_lookup",
+      "blockrun_phone_lookup_fraud",
+      "blockrun_phone_numbers_buy",
+      "blockrun_phone_numbers_renew",
+      "blockrun_phone_numbers_list",
+      "blockrun_phone_numbers_release",
+      "blockrun_voice_call",
+      "blockrun_voice_status"
+    ],
+    "webSearchProviders": ["blockrun-exa"]
+  },
   "configSchema": {
     "type": "object",
     "properties": {