feat(openclaw): add MPP support, serve/claude commands, dual-wallet

- Add `serve` command for local paid inference proxy
- Add `claude` command with --model flag (default minimax/minimax-m2.7)
- Add MPP payment protocol to OpenClaw plugin inference proxy and x_request tool
- Add /x_send slash command with confirmation flow
- Add default Surf provider config (works out of the box)
- Migrate plugin to definePluginEntry SDK
- Rename x_balance -> x_wallet, x_payment -> x_request (old names kept as aliases)
- Add addressForNetwork and parseMppAmount shared helpers
- Replace hardcoded eip155:4217 with TEMPO_NETWORK constant
- Deduplicate SSE tracking into createSseTracker()
- Fix preferredNetwork string comparison bug in serve command

Author: tenequm

packages/x402-proxy/CHANGELOG.md

@@ -7,6 +7,34 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.10.0] - 2026-04-01
+
+### Added
+- `serve` command - local HTTP proxy server for paid inference endpoints, auto-detects wallet and preferred network
+- `claude` command - run Claude Code through a paid local proxy with `ANTHROPIC_BASE_URL` auto-configured
+- `--model` flag on `claude` command (default: `minimax/minimax-m2.7`) - sets `ANTHROPIC_CUSTOM_MODEL_OPTION` for non-Anthropic models
+- MPP payment support in OpenClaw plugin - inference proxy and `x_request` tool now handle both x402 (Solana) and MPP (Tempo/Base) protocols
+- `/x_send` slash command with confirmation flow (5-min TTL) for USDC transfers from the OpenClaw gateway
+- Default Surf provider config - plugin works out of the box without explicit provider configuration
+- `defaults.ts` module with provider config types, resolution logic, and built-in model catalog
+- Dual-wallet support in OpenClaw plugin - EVM and Solana addresses resolved independently
+- `addressForNetwork` and `parseMppAmount` exported as shared helpers from `tools.ts`
+
+### Changed
+- OpenClaw plugin migrated to `definePluginEntry` SDK (from hand-rolled types)
+- `x_balance` tool renamed to `x_wallet` (alias: `x_balance`)
+- `x_payment` tool renamed to `x_request` (alias: `x_payment`) with x402/MPP protocol branching
+- `/x_wallet` command: `send` subcommand now redirects to `/x_send`
+- Inference proxy route handler renamed from `createX402RouteHandler` to `createInferenceProxyRouteHandler`
+- SSE token tracking deduplicated into `createSseTracker()` helper shared by x402 and MPP paths
+- Replaced hardcoded `"eip155:4217"` with imported `TEMPO_NETWORK` constant
+- `serve` and `claude` commands handle their own SIGINT/SIGTERM (CLI entry point skips default handler for them)
+- Wallet loading in plugin uses proper promise dedup (`walletLoadPromise`) instead of boolean flag
+- Providers sorted once in route handler closure instead of per-request
+
+### Fixed
+- `preferredNetwork === "undefined"` string comparison in serve command replaced with proper `preferredNetwork || undefined` check
+
 ## [0.9.4] - 2026-03-27
 
 ### Fixed
@@ -300,7 +328,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `appendHistory` / `readHistory` / `calcSpend` - JSONL transaction history
 - Re-exports from `@x402/fetch`, `@x402/svm`, `@x402/evm`
 
-[Unreleased]: https://github.com/cascade-protocol/x402-proxy/compare/v0.9.4...HEAD
+[Unreleased]: https://github.com/cascade-protocol/x402-proxy/compare/v0.10.0...HEAD
+[0.10.0]: https://github.com/cascade-protocol/x402-proxy/compare/v0.9.4...v0.10.0
 [0.9.4]: https://github.com/cascade-protocol/x402-proxy/compare/v0.9.3...v0.9.4
 [0.9.3]: https://github.com/cascade-protocol/x402-proxy/compare/v0.9.2...v0.9.3
 [0.9.2]: https://github.com/cascade-protocol/x402-proxy/compare/v0.9.1...v0.9.2

packages/x402-proxy/README.md

@@ -81,6 +81,8 @@ $ npx x402-proxy https://api.example.com/data | jq '.results'
 
 ```bash
 $ npx x402-proxy <url>                    # paid HTTP request (default command)
+$ npx x402-proxy serve                    # local paid inference proxy server
+$ npx x402-proxy claude                   # run Claude Code through a paid local proxy
 $ npx x402-proxy mcp <url>                # MCP stdio proxy for agents
 $ npx x402-proxy mcp add <name> <url>     # install MCP server into your AI client
 $ npx x402-proxy setup                    # onboarding wizard
@@ -141,9 +143,11 @@ See the [library API docs](https://github.com/cascade-protocol/x402-proxy/tree/m
 
 ## OpenClaw Plugin
 
-x402-proxy ships as an [OpenClaw](https://openclaw.dev) plugin, giving your gateway automatic x402 payment capabilities. Registers `x_balance` and `x_payment` tools, `/x_wallet` command, and an HTTP route proxy for upstream x402 endpoints.
+x402-proxy ships as an [OpenClaw](https://openclaw.dev) plugin, giving your gateway automatic x402 and MPP payment capabilities. Registers `x_wallet` and `x_request` tools (aliased as `x_balance`/`x_payment`), `/x_wallet` and `/x_send` commands, and an HTTP route proxy for upstream inference endpoints.
 
-Configure providers and models in OpenClaw plugin settings. Uses the standard wallet resolution (env vars or `wallet.json`).
+By default, the plugin registers a built-in `surf` provider at `/x402-proxy/v1` that points at `https://surf.cascade.fyi/api/v1/inference` and prefers MPP. Uses the standard wallet resolution (env vars or `wallet.json`).
+
+For MPP-backed inference, make sure the wallet source includes an EVM key as well as Solana. `npx x402-proxy setup` does this automatically.
 
 ## License
 

packages/x402-proxy/openclaw.plugin.json

@@ -1,18 +1,61 @@
 {
   "id": "x402-proxy",
-  "name": "x402 Proxy",
-  "description": "x402/MPP payments, Solana wallet, and inference proxying",
+  "name": "mpp/x402 Payments Proxy",
+  "description": "x402 and MPP payments, wallet tools, and paid inference proxying",
   "version": "1.0.0",
+  "providers": ["surf"],
+  "autoEnableWhenConfiguredProviders": ["surf"],
+  "skills": ["skills"],
+  "contracts": {
+    "tools": ["x_wallet", "x_balance", "x_request", "x_payment"]
+  },
   "configSchema": {
     "type": "object",
+    "additionalProperties": false,
     "properties": {
       "providers": {
         "type": "object",
-        "description": "Provider catalog keyed by name, each with baseUrl and models array"
+        "description": "Provider catalog keyed by name. Defaults to the built-in surf provider when omitted.",
+        "additionalProperties": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "baseUrl": {
+              "type": "string",
+              "description": "Gateway base path for this provider, typically under /x402-proxy"
+            },
+            "upstreamUrl": {
+              "type": "string",
+              "description": "Upstream inference origin to proxy to"
+            },
+            "protocol": {
+              "type": "string",
+              "enum": ["x402", "mpp", "auto"],
+              "description": "Payment protocol for this provider. Defaults to mpp."
+            },
+            "mppSessionBudget": {
+              "type": "string",
+              "description": "Maximum USDC budget to lock for MPP sessions for this provider (default: 0.5)"
+            },
+            "models": {
+              "type": "array",
+              "description": "Static OpenClaw model catalog entries for this provider"
+            }
+          }
+        }
+      },
+      "protocol": {
+        "type": "string",
+        "enum": ["x402", "mpp", "auto"],
+        "description": "Default payment protocol fallback for providers that do not override it."
+      },
+      "mppSessionBudget": {
+        "type": "string",
+        "description": "Default maximum USDC budget to lock for MPP sessions (default: 0.5)"
       },
       "keypairPath": {
         "type": "string",
-        "description": "Optional path to Solana keypair JSON file (overrides x402-proxy wallet resolution)"
+        "description": "Optional path to Solana keypair JSON file (overrides x402-proxy wallet resolution for Solana/x402 surfaces)"
       },
       "rpcUrl": {
         "type": "string",
@@ -24,5 +67,27 @@
       }
     },
     "required": []
+  },
+  "uiHints": {
+    "protocol": {
+      "label": "Default protocol",
+      "help": "Used only when a provider entry does not set its own protocol."
+    },
+    "mppSessionBudget": {
+      "label": "Default MPP budget",
+      "placeholder": "0.5"
+    },
+    "keypairPath": {
+      "label": "Solana keypair path",
+      "advanced": true
+    },
+    "rpcUrl": {
+      "label": "Solana RPC URL",
+      "advanced": true
+    },
+    "dashboardUrl": {
+      "label": "Dashboard URL",
+      "advanced": true
+    }
   }
 }

packages/x402-proxy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x402-proxy",
-  "version": "0.9.4",
+  "version": "0.10.0",
   "description": "curl for x402 paid APIs. Auto-pays any endpoint on Base, Solana, and Tempo. Also works as an OpenClaw plugin.",
   "type": "module",
   "sideEffects": false,
@@ -20,7 +20,18 @@
   "openclaw": {
     "extensions": [
       "./dist/openclaw/plugin.js"
-    ]
+    ],
+    "providers": [
+      "surf"
+    ],
+    "compat": {
+      "pluginApi": ">=2026.3.24",
+      "minGatewayVersion": "2026.3.24"
+    },
+    "build": {
+      "openclawVersion": "2026.3.24",
+      "pluginSdkVersion": "2026.3.24"
+    }
   },
   "bin": {
     "x402-proxy": "./dist/bin/cli.js"

packages/x402-proxy/skills/SKILL.md

@@ -41,6 +41,8 @@ npx x402-proxy https://api.example.com/data > response.json
 
 ```
 x402-proxy <url>                        # paid HTTP request (default)
+x402-proxy serve                        # local paid inference proxy server
+x402-proxy claude                       # run Claude Code through paid local proxy
 x402-proxy mcp <url>                    # MCP stdio proxy for AI agents
 x402-proxy mcp add <name> <url>         # install MCP server into AI client
 x402-proxy setup                        # wallet onboarding wizard
@@ -174,7 +176,7 @@ openclaw plugins install x402-proxy
 npx x402-proxy setup   # creates wallet if needed
 ```
 
-Registers: `x_balance` tool, `x_payment` tool, `/x_wallet` command, `/x402/*` HTTP route for inference proxying.
+Registers: `x_wallet` tool, `x_request` tool (aliased as `x_balance`/`x_payment`), `/x_wallet` and `/x_send` commands, `/x402-proxy/*` HTTP route for inference proxying.
 
 ## Library API
 

packages/x402-proxy/skills/references/openclaw-plugin.md

@@ -1,13 +1,14 @@
 # OpenClaw Plugin Setup
 
-x402-proxy ships as an [OpenClaw](https://openclaw.dev) plugin. Gives your gateway automatic x402 payment, wallet management, and pay-per-use inference proxying via Solana USDC.
+x402-proxy ships as an [OpenClaw](https://openclaw.dev) plugin. Gives your gateway automatic x402 and MPP payment, wallet management, and pay-per-use inference proxying via USDC on Solana, Base, and Tempo.
 
 ## What it registers
 
-- **`x_balance` tool** - check wallet SOL/USDC balances, daily spend, available funds
-- **`x_payment` tool** - call any x402-enabled endpoint with automatic payment (params: `url`, `method`, `params`, `headers`)
-- **`/x_wallet` command** - wallet status dashboard, `send <amount|all> <address>`, `history [page]`
-- **HTTP route `/x402/*`** - proxies requests to upstream inference endpoints with payment, tracks token usage and cost
+- **`x_wallet` tool** (alias: `x_balance`) - check wallet readiness, balances, and spend history for x402 and MPP payments
+- **`x_request` tool** (alias: `x_payment`) - call a paid HTTP endpoint with automatic x402 or MPP settlement (params: `url`, `method`, `params`, `headers`, `protocol`)
+- **`/x_wallet` command** - wallet status dashboard, `history [page]`
+- **`/x_send` command** - send USDC with confirmation step (`/x_send <amount|all> <address>`, then `/x_send confirm`)
+- **HTTP route `/x402-proxy/*`** - proxies requests to upstream inference endpoints with payment, tracks token usage and cost
 
 ## Step 1: Install the plugin
 
@@ -36,6 +37,15 @@ Or set an explicit keypair in plugin config (step 3).
 
 ## Step 3: Configure providers and models
 
+If you do nothing, the plugin now defaults to:
+
+- provider id: `surf`
+- gateway base URL: `/x402-proxy/v1`
+- upstream: `https://surf.cascade.fyi/api/v1/inference`
+- protocol: `mpp`
+
+You only need explicit config if you want to override the defaults or supply a custom model catalog.
+
 Add the plugin config to your `openclaw.json` (or via `openclaw config edit`):
 
 ```json
@@ -46,7 +56,7 @@ Add the plugin config to your `openclaw.json` (or via `openclaw config edit`):
         "config": {
           "providers": {
             "surf-inference": {
-              "baseUrl": "/x402/v1",
+              "baseUrl": "/x402-proxy/v1",
               "upstreamUrl": "https://surf.cascade.fyi/api/v1/inference",
               "models": [
                 { "id": "anthropic/claude-opus-4.6", "name": "Claude Opus 4.6", "maxTokens": 200000, "reasoning": true, "input": ["text", "image"], "cost": { "input": 0.015, "output": 0.075, "cacheRead": 0.0015, "cacheWrite": 0.01875 }, "contextWindow": 200000 },
@@ -78,7 +88,7 @@ Add the plugin config to your `openclaw.json` (or via `openclaw config edit`):
 
 | Field | Description |
 |-------|-------------|
-| `providers.<name>.baseUrl` | Route path registered in OpenClaw (e.g., `/x402/v1`) |
+| `providers.<name>.baseUrl` | Route path registered in OpenClaw (e.g., `/x402-proxy/v1`) |
 | `providers.<name>.upstreamUrl` | Actual upstream endpoint (e.g., `https://surf.cascade.fyi/api/v1/inference`) |
 | `providers.<name>.models[]` | Model catalog array |
 | `keypairPath` | Optional path to solana-keygen JSON file (overrides wallet resolution) |
@@ -111,8 +121,8 @@ openclaw models    # verify models appear
 
 1. Plugin boots, loads wallet via the resolution cascade
 2. Registers each provider from config into OpenClaw's model catalog (API type: `openai-completions`, no auth required)
-3. HTTP route `/x402/*` intercepts inference requests, strips prefix, proxies to `upstreamUrl`
-4. On 402 response, auto-signs a Solana USDC payment and retries
+3. HTTP route `/x402-proxy/*` intercepts inference requests, strips prefix, proxies to `upstreamUrl`
+4. On 402 response, auto-pays via MPP (Tempo/Base) or x402 (Solana) depending on provider config
 5. SSE streaming responses are parsed for token usage and logged to `~/.config/x402-proxy/history.jsonl`
 6. Tools and command are available to all agents on the gateway
 
@@ -131,5 +141,5 @@ Then update the `models` array in your plugin config accordingly.
 
 - **Models don't appear in `openclaw models`** - the plugin uses a `catalog` hook (not `models` field). Make sure you're on x402-proxy >= 0.8.5.
 - **"no wallet found" in logs** - run `npx x402-proxy setup` or set `X402_PROXY_WALLET_MNEMONIC` env var before starting the gateway.
-- **402 errors on inference** - check wallet has USDC balance: use `x_balance` tool or `npx x402-proxy wallet`.
+- **402 errors on inference** - check wallet has USDC balance: use `x_wallet` tool or `npx x402-proxy wallet`.
 - **Gateway cold start slow** - normal on small VMs (~72s). The `x402-wallet` service eagerly loads the wallet during boot.

packages/x402-proxy/src/app.ts

@@ -1,10 +1,12 @@
 declare const __VERSION__: string;
 
 import { buildApplication, buildRouteMap } from "@stricli/core";
+import { claudeCommand } from "./commands/claude.js";
 import { configSetCommand, configShowCommand, configUnsetCommand } from "./commands/config.js";
 import { fetchCommand } from "./commands/fetch.js";
 import { mcpCommand } from "./commands/mcp.js";
 import { mcpAddCommand } from "./commands/mcp-add.js";
+import { serveCommand } from "./commands/serve.js";
 import { setupCommand } from "./commands/setup.js";
 import { statusCommand } from "./commands/status.js";
 import { walletInfoCommand } from "./commands/wallet.js";
@@ -49,6 +51,8 @@ const mcpRoutes = buildRouteMap({
 const routes = buildRouteMap({
   routes: {
     fetch: fetchCommand,
+    serve: serveCommand,
+    claude: claudeCommand,
     mcp: mcpRoutes,
     wallet: walletRoutes,
     config: configRoutes,

packages/x402-proxy/src/bin/cli.ts

@@ -3,9 +3,6 @@ import { run } from "@stricli/core";
 import { app } from "../app.js";
 import { buildContext } from "../context.js";
 
-// Ensure Ctrl+C always exits cleanly (raw mode from @clack/prompts can swallow SIGINT)
-process.on("SIGINT", () => process.exit(130));
-
 // Pre-process args before Stricli parses them
 const rawArgs = process.argv.slice(2);
 const args: string[] = [];
@@ -27,4 +24,11 @@ for (let i = 0; i < rawArgs.length; i++) {
     args.push(a);
   }
 }
+
+const topLevelCommand = args[0];
+if (topLevelCommand !== "serve" && topLevelCommand !== "claude") {
+  // Ensure Ctrl+C always exits cleanly (raw mode from @clack/prompts can swallow SIGINT)
+  process.on("SIGINT", () => process.exit(130));
+}
+
 await run(app, args, buildContext(process));