v0.10.15 — Root-cause fix: toolCalling capability flag prevents routing tool requests to incompatible models

feat: toolCalling capability flag + routing filter

Why v0.10.14 was directionally correct but incomplete

v0.10.14 removed grok-code-fast-1 from tier configs. That stopped the immediate bleeding, but the root cause remained: ClawRouter had no mechanism to prevent incompatible models from entering the routing chain when a request includes tool schemas. Any future model added to tier configs with the same issue would cause the same bug.

What v0.10.15 adds

A toolCalling capability flag on every model definition and a routing filter that enforces it.

models.ts — new flag on BlockRunModel:

toolCalling?: boolean
// true  → supports OpenAI-compatible structured function/tool calling
// false/omitted → outputs tool invocations as plain text (skipped when request has tools)

Models WITHOUT toolCalling:

• xai/grok-code-fast-1 — outputs {"command":"..."} as plain text (the original bug)
• nvidia/gpt-oss-120b — free model, structured function call support unverified

selector.ts — new filterByToolCalling() function:

• When request has tools, removes models without toolCalling: true from the fallback chain
• If no capable model remains, returns the full chain (API error beats silent failure)

proxy.ts — applies the filter after context-window filtering:

[ClawRouter] Tool-calling filter: excluded xai/grok-code-fast-1 (no structured function call support)

Upgrade

openclaw plugins update clawrouter
# or
openclaw plugins install @blockrun/clawrouter@0.10.15

v0.10.14 — Fix 'talking to itself' bug (remove grok-code-fast-1 from tool-use paths)

Fix: Replace grok-code-fast-1 with kimi-k2.5 in MEDIUM routing tiers

Problem

Multiple users reported that ClawRouter was "talking to itself" — showing raw JSON like {"command":"..."} as visible chat messages instead of silently executing tool calls. A large error block would sometimes appear in the chat as a result.

Root cause: xai/grok-code-fast-1 (Grok Code Fast) does not properly handle OpenClaw's function call format. When given tool schemas, it outputs tool invocations as plain text JSON in the response body rather than as structured function calls. OpenClaw displays this raw JSON as a visible message, making it look like the AI is narrating its own actions.

Fix

Replaced grok-code-fast-1 with moonshot/kimi-k2.5 as the primary model for MEDIUM-complexity tasks in both the default and agentic tier configs. Kimi K2.5 has strong tool-use support and correctly uses OpenClaw's structured function call format.

Config path	Before	After
tiers.MEDIUM.primary	xai/grok-code-fast-1	moonshot/kimi-k2.5
agenticTiers.MEDIUM.primary	xai/grok-code-fast-1	moonshot/kimi-k2.5
premiumTiers.SIMPLE.fallback[2]	xai/grok-code-fast-1	deepseek/deepseek-chat

grok-code-fast-1 is no longer used in any routing path.

Upgrade

openclaw plugins update clawrouter
# or
openclaw plugins install @blockrun/clawrouter@0.10.14

v0.10.13 — Fix async plugin registration (issue #56)

Fix: make register() synchronous for OpenClaw compatibility

Reported by: @KevinkeVarson in #56 — thank you for the detailed reproduction steps and version bisect!

Problem

After upgrading from 0.10.10 to 0.10.12, OpenClaw logs:

[gateway] [plugins] plugin register returned a promise; async registration is ignored (plugin=clawrouter, source=~/.openclaw/extensions/clawrouter/dist/index.js)

Routing never initializes — blockrun/auto and all BlockRun models stop working silently.

Root Cause

In 0.10.12, a dynamic await import('./partners/index.js') inside register() turned the entire function async, causing it to return a Promise. OpenClaw's plugin loader does not await plugin registration — it discards the promise and skips all initialization that follows.

Fix

Converted the dynamic await import() to a static top-level import, removing the only await in register(). The function is now fully synchronous. All other async work (proxy startup, wallet initialization, command registration) was already fire-and-forget via .then() and is unaffected.

Files Changed

File	Change
src/index.ts	Add static import for partners/index.js; remove async from register(); remove dynamic await import()
package.json	Version bump 0.10.12 → 0.10.13

Upgrade

openclaw plugins update clawrouter
# or
openclaw plugins install @blockrun/clawrouter@0.10.13

Fixes #56

v0.10.12 — Fix system prompt scoring (issue #50)

Fix: Score all keyword dimensions against user text only

Reported by: @Machiel692 in #50 — thank you for the exceptionally detailed bug report and follow-up testing!

Problem

When ClawRouter is used as an OpenClaw plugin, the system prompt (~6,000 tokens with 20+ tool definitions) contains keywords that match nearly every scoring dimension. This caused all requests to score identically (~0.47) regardless of user intent, making blockrun/auto routing completely non-functional.

Root Cause

13 of 15 scoring dimensions in classifyByRules() scored against the concatenated system prompt + user message. The user's actual query (<1% of scored text) had no measurable impact on the score.

Fix

Changed all keyword-based scoring dimensions to score against userText only (the user's message), matching the pattern already established for reasoningMarkers and scoreAgenticTask. The tokenCount dimension still uses total context size since that legitimately affects model selection.

Before vs After

Query	Score Before	Score After
"What time is it?"	~0.47	0.080
"What's the weather?"	~0.47	0.080
Complex coding task	~0.47	0.182
Math proof (reasoning)	~0.47	0.260

Scores now differentiate properly across query complexity levels.

Testing

• 214 unit tests pass
• 40 e2e tests pass (including new OpenClaw-scale system prompt scenario)

Files Changed

File	Change
src/router/rules.ts	Score all keyword dimensions against userText only
test/e2e.ts	Add OpenClaw-scale system prompt e2e test
package.json	Version bump 0.10.11 → 0.10.12

Fixes #50

v0.10.11

What's New

Routing Debug Headers

Added x-clawrouter-* response headers that expose the full routing decision for every request — making it easy to see exactly which profile, tier, model, and scoring was used.

Debug mode is ON by default. To disable, send x-clawrouter-debug: false header.

Non-streaming responses

Returns these HTTP response headers:

Header	Example	Description
x-clawrouter-profile	eco, auto, premium	Which routing profile was used
x-clawrouter-tier	SIMPLE, MEDIUM, COMPLEX, REASONING	Complexity tier assigned
x-clawrouter-model	anthropic/claude-sonnet-4.6	Actual model that served the request
x-clawrouter-confidence	0.85	Router confidence in tier assignment (0-1)
x-clawrouter-reasoning	score=0.12 | reasoning_keywords(2) | agentic	Full scoring breakdown
x-clawrouter-agentic-score	0.60	Agentic task detection score (0-1, triggers agentic tiers at ≥0.5)

Streaming responses

Emits an SSE comment before data starts (invisible to standard SSE clients, visible in raw stream):

: x-clawrouter-debug profile=auto tier=REASONING model=xai/grok-4-1-fast-reasoning agentic=0.00 confidence=0.97 reasoning=score=0.10 | short (15 tokens), reasoning (prove, step by step)

Usage

# Debug ON (default) — headers included automatically
curl -v http://127.0.0.1:8402/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"blockrun/auto","messages":[{"role":"user","content":"hello"}]}'

# Debug OFF — no routing headers
curl http://127.0.0.1:8402/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "x-clawrouter-debug: false" \
  -d '{"model":"blockrun/auto","messages":[{"role":"user","content":"hello"}]}'

How routing works

ClawRouter routes requests through these steps:

1. Profile selection — based on model name (blockrun/eco, blockrun/auto, blockrun/premium)
2. Rule-based scoring — 14 weighted dimensions classify prompt complexity in <1ms
3. Tier assignment — SIMPLE → MEDIUM → COMPLEX → REASONING
4. Agentic detection — if agentic score ≥ 0.5, switches to agentic-optimized model tiers
5. Model selection — picks cheapest capable model for the tier + profile
6. Fallback chain — if primary model fails, tries fallbacks filtered by context window size

Bug Fixes

• Fixed Gemini API "function call turn" ordering errors in upstream BlockRun API
• Fixed prettier formatting across all source files
• Removed unused imports in doctor.ts

Internal

• Added agenticScore to RoutingDecision type for full observability pipeline
• Fallback chain now correctly respects routing profile (eco/auto/premium) tier configs

v0.10.10 — Fix Auto Mode Routing to Sonnet

ClawRouter v0.10.9 — Fix Agentic Mode False Trigger (Auto Mode Routing to Sonnet)

Release Date: 2026-02-24

---

🐛 Bug Fix: blockrun/auto no longer routes all requests to Sonnet

Root cause: agenticScore was computed from systemPrompt + userPrompt combined text. Coding assistant system prompts (e.g., OpenClaw's) contain words like "edit files", "fix bugs", "check", "verify", "deploy", "make sure" — matching 3+ agentic keywords and triggering agentic mode (agenticScore ≥ 0.6) on every request, regardless of what the user actually asked.

In agentic mode, COMPLEX/REASONING tier routes to claude-sonnet-4.6, causing all queries to hit Sonnet.

Fix: agenticScore now only scores the user's prompt, not the system prompt. The system prompt describes how the assistant should behave — it should not influence whether the user is requesting a multi-step agentic task.

Behavior change

Scenario	Before	After
"What is React?" (coding system prompt)	agentic mode → Sonnet	standard routing → kimi/grok
"What does this function do?" (coding system prompt)	agentic mode → Sonnet	standard routing → kimi
"Fix the bug, deploy, make sure it works"	agentic mode ✓	agentic mode ✓ (unchanged)
User explicitly requests multi-step task	agentic mode ✓	agentic mode ✓ (unchanged)

---

📋 Files Changed

File	Change
src/router/rules.ts	scoreAgenticTask uses userText instead of combined text
test/e2e.ts	Add regression tests for coding system prompt agentic false trigger
package.json	Version bump 0.10.8 → 0.10.9

---

🔢 Stats

• Tests: 214 unit passed + 36 e2e passed, 0 failed

v0.10.9 — Fix x402 Payment Verification Failures

ClawRouter v0.10.9 — Fix x402 Payment Verification Failures

Release Date: 2026-02-24

---

🐛 Bug Fixes: x402 Payment Reliability

Three root causes behind intermittent "Payment verification failed" errors, all in ClawRouter's local pre-processing logic. The BlockRun server was working correctly throughout.

Fix 1: Payment failures no longer silently surface to users

ClawRouter checks errors against PROVIDER_ERROR_PATTERNS to decide whether to retry with a fallback model. "Payment verification failed", "model not allowed", and "unknown model" were missing from this list — ClawRouter was surfacing these errors directly instead of triggering the fallback chain.

Added patterns:

• /payment.*verification.*failed/i
• /model.*not.*allowed/i
• /unknown.*model/i

Fix 2: Pre-auth payment amount below CDP Facilitator minimum

ClawRouter pre-signs payment authorizations before sending requests (pre-auth optimization). The minimum signed amount was 100 micros ($0.0001), but CDP Facilitator enforces a minimum of 1000 micros ($0.001). Any request whose estimated cost fell below this threshold would be rejected by CDP with "signed_amount < required_amount", even with sufficient wallet balance.

Changed: Math.max(100, ...) → Math.max(1000, ...) in estimateAmount()

Fix 3: blockrun/moonshot model alias missing

blockrun/moonshot would strip to bare "moonshot", which had no alias mapping, causing ClawRouter to forward the unresolved string to the server. The server correctly rejected an unrecognized model ID.

Added aliases: moonshot and kimi-k2.5 → moonshot/kimi-k2.5

---

📋 Files Changed

File	Change
src/proxy.ts	Add 3 missing patterns to PROVIDER_ERROR_PATTERNS; fix estimateAmount minimum
src/models.ts	Add moonshot and kimi-k2.5 aliases
package.json	Version bump 0.10.8 → 0.10.9

---

🔢 Stats

• E2E Tests: 33 passed, 0 failed
• Live payment test: ✓ moonshot/kimi-k2.5 via x402 on Base mainnet

v0.10.8 — Fix Partner Tool OpenClaw API Contract

ClawRouter v0.10.8 — Fix Partner Tool OpenClaw API Contract

Release Date: 2026-02-24

---

🐛 Bug Fix: Partner Tools Now Work Correctly in OpenClaw

Three API contract mismatches between ClawRouter and OpenClaw's tool execution interface, discovered and reported by a user.

Bug 1: inputSchema → parameters

OpenClaw expects tool parameter schema under the key parameters, but ClawRouter was using inputSchema. The model had no way to know how to pass arguments.

Bug 2: execute(args) → execute(toolCallId, params)

OpenClaw calls execute(toolCallId, params) — the first argument is the tool call ID, the second is the actual parameters. ClawRouter's execute(args) was receiving toolCallId as the parameter object and sending it to the upstream API.

Bug 3: Return format

OpenClaw expects { content: [{ type: "text", text: "..." }], details: ... }. ClawRouter was returning raw JSON, which OpenClaw couldn't display.

---

📋 File Changed

File	Change
src/partners/tools.ts	Fix all 3 OpenClaw tool API contract issues
package.json	Version bump 0.10.7 → 0.10.8

---

🔢 Stats

• Tests: 214 passed, 3 skipped, 0 failed

v0.10.7 — Partner Tool Fixes & Wallet Safety

ClawRouter v0.10.7 — Partner Tool Fixes & Wallet Safety

Release Date: 2026-02-24

---

🎉 Highlights

• ✅ Partner tool now triggers reliably — AI will always call blockrun_x_users_lookup instead of answering from memory
• ✅ Baseline cost calculation fixed — savings % now computed correctly against claude-opus-4.6
• ✅ Wallet safety hardened — corrupted wallet file throws instead of silently overwriting

---

🔧 Fixes

Fix: Partner tool description uses directive language

File: src/partners/registry.ts

The blockrun_x_users_lookup tool was registered correctly but the AI rarely called it — it would answer Twitter/X user questions from its training data instead.

Root cause: The description said what the tool is, not when the AI must use it.

Before:

"Look up Twitter/X user profiles by username. Returns follower counts,
verification status, bio, and more. Accepts up to 100 usernames per request."

After:

"ALWAYS use this tool to look up real-time Twitter/X user profiles.
Call this when the user asks about any Twitter/X account, username, handle,
follower count, verification status, bio, or profile.
Do NOT answer Twitter/X user questions from memory — always fetch live data with this tool.
Returns: follower count, verification badge, bio, location, join date.
Accepts up to 100 usernames per request (without @ prefix)."

How to trigger: Ask the AI "Look up Twitter user @blockrunai" or "Get info on these X accounts: @naval, @balajis"

---

Fix: /partners command shows usage hint

File: src/index.ts

The /partners command output now includes a How to use line so users know how to phrase requests to trigger partner tools.

---

Fix: Baseline cost always returned zero

File: src/router/selector.ts

BASELINE_MODEL_ID was set to "anthropic/claude-opus-4-5" (hyphen, old ID) but the model registry uses "anthropic/claude-opus-4.6" (dot). The pricing lookup always returned undefined, making baselineCost = 0 and savings = 0% for all routes.

Before: const BASELINE_MODEL_ID = "anthropic/claude-opus-4-5";
After: const BASELINE_MODEL_ID = "anthropic/claude-opus-4.6";

---

Fix: Wallet corruption throws instead of silently overwriting

File: src/auth.ts

Previously, if the wallet file existed but had an invalid format, ClawRouter would silently fall through and generate a new empty wallet — potentially abandoning a funded wallet.

Now: throws a descriptive error with recovery instructions:

CRITICAL: Wallet file exists but has invalid format!
Refusing to auto-generate new wallet to protect existing funds.
Restore your backup key or set BLOCKRUN_WALLET_KEY env var.

Also adds a prominent backup reminder banner when a new wallet is generated for the first time.

---

📋 Files Changed

File	Change
src/partners/registry.ts	Directive tool description for x_users_lookup
src/index.ts	Usage hint in /partners command output
src/router/selector.ts	Fix BASELINE_MODEL_ID typo (4-5 → 4.6)
src/router/selector.test.ts	Update test mock to match corrected baseline ID
src/auth.ts	Wallet corruption safety + new-wallet backup reminder
package.json	Version bump 0.10.6 → 0.10.7

---

🔢 Stats

• Files changed: 6
• Tests: 214 passed, 3 skipped, 0 failed

v0.10.6 - Partner APIs + Direct Model Cost Tracking

Partner API Integration

ClawRouter now supports partner APIs through the same wallet — zero extra setup. First partner: AttentionVC (Twitter/X user intelligence).

How it works

Agent → ClawRouter proxy → x402 payment → BlockRun API → AttentionVC → Twitter/X data

Your existing funded wallet handles payment automatically. Partner API calls route to /v1/x/* and /v1/partner/* through a new simplified proxy path (no smart routing, SSE, or compression — just forward + pay).

New: clawrouter partners CLI

# List available partner APIs with pricing
clawrouter partners

# Test endpoints (402 = alive and payment-gated)
clawrouter partners test

OpenClaw Integration

Partner tools are auto-registered when running as an OpenClaw plugin:

• Tool: blockrun_x_users_lookup — batch Twitter/X profile lookup
• Command: /partners — list available partner APIs in-chat

New files

• src/partners/registry.ts — partner service definitions
• src/partners/tools.ts — OpenClaw tool wrappers
• src/partners/index.ts — barrel export

---

Fix: Direct Model Cost Tracking

Bug: When a user explicitly picked a model (e.g. claude-sonnet-4-20250514) instead of using a routing profile (auto/eco/premium), the request cost was not tracked in /stats totals. Only auto-routed requests were logged.

Root cause: routingDecision was only set for routing profiles. Direct model picks left it undefined, skipping the logUsage() call entirely.

Fix: Now logs ALL requests — routed requests keep their existing tier, direct model picks get a new DIRECT tier visible in stats.

---

Install / Upgrade

npm install -g @blockrun/clawrouter@0.10.6