@blockrun/clawrouter 0.10.1 → 0.10.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -33,17 +33,18 @@ One wallet, 38+ models, zero API keys.
33
33
 
34
34
  ## 📑 Quick Navigation
35
35
 
36
- | Section | Description |
37
- | ----------------------------------------- | --------------------------- |
38
- | [Quick Start](#-quick-start) | Install in 2 minutes |
39
- | [Routing Profiles](#-routing-profiles) | eco / auto / premium / free |
40
- | [How It Works](#-how-it-works) | 15-dimension local routing |
41
- | [Models & Pricing](#-models--pricing) | 30+ models, full price list |
42
- | [Screenshots](#-screenshots) | See it in action |
43
- | [Payment](#-payment) | x402 non-custodial USDC |
44
- | [Configuration](#%EF%B8%8F-configuration) | Environment variables |
45
- | [vs OpenRouter](#-vs-openrouter) | Why ClawRouter wins |
46
- | [Support](#-support) | Telegram, X, founders |
36
+ | Section | Description |
37
+ | ----------------------------------------- | ------------------------------ |
38
+ | [Quick Start](#-quick-start) | Install in 2 minutes |
39
+ | [Routing Profiles](#-routing-profiles) | eco / auto / premium / free |
40
+ | [How It Works](#-how-it-works) | 15-dimension local routing |
41
+ | [Models & Pricing](#-models--pricing) | 30+ models, full price list |
42
+ | [Screenshots](#-screenshots) | See it in action |
43
+ | [Payment](#-payment) | x402 non-custodial USDC |
44
+ | [Configuration](#%EF%B8%8F-configuration) | Environment variables |
45
+ | [Troubleshooting](#-troubleshooting) | `doctor` AI-powered diagnostics |
46
+ | [vs OpenRouter](#-vs-openrouter) | Why ClawRouter wins |
47
+ | [Support](#-support) | Telegram, X, founders |
47
48
 
48
49
  ---
49
50
 
@@ -219,6 +220,48 @@ For basic usage, no configuration needed. For advanced options:
219
220
 
220
221
  ---
221
222
 
223
+ ## 🩺 Troubleshooting
224
+
225
+ **When things go wrong, run the doctor:**
226
+
227
+ ```bash
228
+ npx @blockrun/clawrouter doctor
229
+ ```
230
+
231
+ This collects diagnostics and sends them to Claude Opus 4.6 for AI-powered analysis:
232
+
233
+ ```
234
+ 🩺 BlockRun Doctor v0.10.1
235
+
236
+ System
237
+ ✓ OS: darwin arm64
238
+ ✓ Node: v20.11.0
239
+ ✓ Memory: 8.2GB free / 16.0GB
240
+
241
+ Wallet
242
+ ✓ Address: 0x1234...abcd
243
+ ✓ Balance: $12.50
244
+
245
+ Network
246
+ ✓ BlockRun API: reachable (142ms)
247
+ ✗ Local proxy: not running on :8402
248
+
249
+ 📤 Sending to Claude Opus 4.6...
250
+
251
+ 🤖 AI Analysis:
252
+ The local proxy isn't running. Run `openclaw gateway restart` to fix.
253
+ ```
254
+
255
+ **Ask a specific question:**
256
+
257
+ ```bash
258
+ npx @blockrun/clawrouter doctor "why is my request failing?"
259
+ ```
260
+
261
+ **Cost:** ~$0.01 per analysis (paid via your wallet balance)
262
+
263
+ ---
264
+
222
265
  ## 🛠 Development
223
266
 
224
267
  ```bash
package/dist/cli.js CHANGED
@@ -4679,6 +4679,7 @@ async function proxyRequest(req, res, apiBase, payFetch, options, routerOpts, de
4679
4679
  } catch (err) {
4680
4680
  const errorMsg = err instanceof Error ? err.message : String(err);
4681
4681
  console.error(`[ClawRouter] Routing error: ${errorMsg}`);
4682
+ console.error(`[ClawRouter] Need help? Run: npx @blockrun/clawrouter doctor`);
4682
4683
  options.onError?.(new Error(`Routing failed: ${errorMsg}`));
4683
4684
  }
4684
4685
  }
@@ -5624,6 +5625,7 @@ async function main() {
5624
5625
  console.error(
5625
5626
  `[ClawRouter] Insufficient funds. Balance: ${info.balanceUSD}, Need: ${info.requiredUSD}`
5626
5627
  );
5628
+ console.error(`[ClawRouter] Need help? Run: npx @blockrun/clawrouter doctor`);
5627
5629
  }
5628
5630
  });
5629
5631
  const monitor = new BalanceMonitor(address);
@@ -5660,6 +5662,7 @@ async function main() {
5660
5662
  }
5661
5663
  main().catch((err) => {
5662
5664
  console.error(`[ClawRouter] Fatal error: ${err.message}`);
5665
+ console.error(`[ClawRouter] Need help? Run: npx @blockrun/clawrouter doctor`);
5663
5666
  process.exit(1);
5664
5667
  });
5665
5668
  //# sourceMappingURL=cli.js.map