agent402-openclaw 0.1.2 → 0.2.0

package/README.md

@@ -33,11 +33,16 @@ export AGENT402_WALLET_KEY=0x...     # an EVM key holding USDC on Base
 With no credits key present the proxy signs an x402 payment per call from that
 wallet. The key never leaves the machine.
 
-## Models
-
-`auto` (routed per prompt) plus every id from `GET https://agent402.tools/v1/models`,
-each routed to its home tier. Prices are per call, not per token, so OpenClaw's
-per-token cost fields are zero. A model sent to the wrong tier is answered with a
+## Models and pricing
+
+`auto` (routed per prompt, flat $0.01/call) plus every id from
+`GET https://agent402.tools/v1/models`. Explicit models are **metered by default**:
+the proxy sends them to the gateway's metered route, where each request is quoted
+from its body (exact-BPE input plus your `max_tokens` at the model's list price,
+times 1.15, from $0.001, capped at $2 per call), so a short call costs a fraction
+of a cent and a long one pays for what it asks. `--flat` (or
+`AGENT402_PRICING=flat`) keeps every model on its flat per-call tier instead.
+Either way OpenClaw's per-token cost fields stay zero; the price is per call. A model sent to the wrong tier is answered with a
 400 naming the right one; nothing is charged. A client-supplied `Idempotency-Key`
 is passed through (an x402 retry with the same key replays the paid answer);
 without one, each call is its own payment.

package/cli.js

@@ -37,11 +37,14 @@ function mergeInto(target, block) {
 
 async function main() {
   if (cmd === "help" || has("--help")) {
-    out("agent402-openclaw setup [--credits-key a402_...] [--write] | proxy [--port N] [--upstream URL] | doctor");
+    out("agent402-openclaw setup [--credits-key a402_...|-] [--write] [--flat] | proxy [--port N] [--upstream URL] [--flat] | doctor");
     return 0;
   }
   const upstream = stripTrailingSlashes(opt("--upstream") || process.env.AGENT402_UPSTREAM || DEFAULT_UPSTREAM);
   const port = Number(opt("--port")) || DEFAULT_PORT;
+  // Pricing: metered by default (explicit models pay a per-request quote, from
+  // $0.001); --flat (or AGENT402_PRICING=flat) keeps every model on its flat tier.
+  const pricing = has("--flat") || String(process.env.AGENT402_PRICING || "").toLowerCase() === "flat" ? "flat" : "metered";
 
   if (cmd === "setup") {
     // The key may arrive on argv (lands in shell history), via AGENT402_CREDITS_KEY,
@@ -59,7 +62,7 @@ async function main() {
       out(`no credits key yet: buy a pack by card at ${upstream}/credits, then rerun with --credits-key a402_...`);
     }
     let routes;
-    try { routes = await loadRoutes(upstream); } catch (e) { console.error(`could not read ${upstream}/v1/models: ${e?.message || e}`); return 2; }
+    try { routes = await loadRoutes(upstream, fetch, { pricing }); } catch (e) { console.error(`could not read ${upstream}/v1/models: ${e?.message || e}`); return 2; }
     const block = configBlock({ port, routes });
     const cfgPath = join(process.env.AGENT402_OPENCLAW_HOME || join(homedir(), ".openclaw"), "openclaw.json");
     if (has("--write")) {
@@ -88,8 +91,8 @@ async function main() {
   if (cmd === "proxy") {
     const creditsKey = resolveCreditsKey();
     const payFetch = creditsKey ? null : await resolvePayFetch({}, (m) => console.error(m));
-    const p = await startProxy({ upstream, creditsKey, payFetch, port, log: (m) => console.error(m) });
-    out(`${p.baseUrl}/v1 (${p.mode})`);
+    const p = await startProxy({ upstream, creditsKey, payFetch, port, pricing, log: (m) => console.error(m) });
+    out(`${p.baseUrl}/v1 (${p.mode}, ${p.pricing} pricing)`);
     await new Promise(() => {}); // run until killed
   }
 
@@ -98,7 +101,7 @@ async function main() {
     out(`upstream: ${upstream}`);
     out(`credits key: ${key ? `present (${key.slice(0, 8)}…)` : "none"}`);
     out(`wallet key: ${/^0x[0-9a-fA-F]{64}$/.test(process.env.AGENT402_WALLET_KEY || "") ? "present" : "none"}`);
-    try { const r = await loadRoutes(upstream); out(`gateway: ok, ${r.size} models`); } catch (e) { out(`gateway: unreachable (${e?.message || e})`); return 1; }
+    try { const r = await loadRoutes(upstream, fetch, { pricing }); out(`gateway: ok, ${r.size} models (${pricing} pricing: ${[...r.values()].filter((x) => x.metered).length} metered)`); } catch (e) { out(`gateway: unreachable (${e?.message || e})`); return 1; }
     if (key) {
       try {
         const r = await fetch(`${upstream}/api/credits/balance`, { headers: { authorization: `Bearer ${key}` }, signal: AbortSignal.timeout(15_000) });

package/index.js

@@ -51,6 +51,7 @@ const plugin = {
     const cfg = api.pluginConfig || {};
     const port = Number(cfg.port) || DEFAULT_PORT;
     const upstream = stripTrailingSlashes(cfg.upstream || process.env.AGENT402_UPSTREAM || DEFAULT_UPSTREAM);
+    const pricing = String(cfg.pricing || process.env.AGENT402_PRICING || "metered").toLowerCase() === "flat" ? "flat" : "metered";
     const log = (m) => api.logger?.info?.(m);
     api.registerProvider(buildProvider({ port }));
     if (!registeredOnce) {
@@ -61,8 +62,8 @@ const plugin = {
           if (started) return;
           const creditsKey = resolveCreditsKey(cfg);
           const payFetch = creditsKey ? null : await resolvePayFetch(cfg, log);
-          try { setCachedRoutes(await loadRoutes(upstream)); } catch (e) { log(`[agent402-openclaw] could not read ${upstream}/v1/models yet: ${e?.message || e}`); }
-          started = await startProxy({ upstream, creditsKey, payFetch, port, log });
+          try { setCachedRoutes(await loadRoutes(upstream, fetch, { pricing })); } catch (e) { log(`[agent402-openclaw] could not read ${upstream}/v1/models yet: ${e?.message || e}`); }
+          started = await startProxy({ upstream, creditsKey, payFetch, port, pricing, log });
           setActiveProxy(started);
           if (started.mode === "unpaid") log("[agent402-openclaw] no payment configured: run `agent402-openclaw setup` (card credits key) - paid calls will answer 402 until then");
         },

package/models.js

@@ -16,19 +16,30 @@ export function stripTrailingSlashes(s) {
 }
 
 
-/** The raw catalog entry -> { id, endpoint, tier, priceUsd, maxTokens, maxInputChars }. */
-export function routesFromCatalog(catalog) {
+/** The raw catalog entry -> { id, endpoint, tier, priceUsd, maxTokens, maxInputChars }.
+ *
+ *  `pricing`: "metered" (default) routes every explicit model to the gateway's
+ *  metered endpoint when the catalog advertises one (`x402.meteredEndpoint`):
+ *  the 402 quotes each request from its body, from `meteredFromUsd`, instead
+ *  of the tier's flat price - a short call costs a fraction of a cent, a long
+ *  one pays for what it asks. "flat" keeps every model on its home tier.
+ *  `auto` always stays on the routed tier (the metered route needs an explicit
+ *  model). */
+export function routesFromCatalog(catalog, { pricing = "metered" } = {}) {
   const data = Array.isArray(catalog?.data) ? catalog.data : [];
   const routes = new Map();
+  const metered = pricing !== "flat";
   for (const m of data) {
     const x = m?.x402;
     if (!m?.id || !x?.endpoint || typeof x.priceUsd !== "number") continue;
     if (String(m.id).endsWith("*")) continue; // family wildcard, not an id
+    const useMetered = metered && typeof x.meteredEndpoint === "string" && x.meteredEndpoint.startsWith("/");
     routes.set(m.id, {
       id: m.id,
-      endpoint: x.endpoint,
-      tier: x.tier || null,
-      priceUsd: x.priceUsd,
+      endpoint: useMetered ? x.meteredEndpoint : x.endpoint,
+      tier: useMetered ? "v1-chat-metered" : (x.tier || null),
+      priceUsd: useMetered ? (Number(x.meteredFromUsd) || x.priceUsd) : x.priceUsd,
+      metered: useMetered,
       maxTokens: Number(x.maxTokens) || 1024,
       maxInputChars: Number(x.maxInputChars) || 32_000,
       stealth: !!x.stealth,
@@ -55,7 +66,7 @@ export function openclawModels(routes) {
   rows.sort((a, b) => (a.id === AUTO_ID ? -1 : b.id === AUTO_ID ? 1 : a.priceUsd - b.priceUsd || a.id.localeCompare(b.id)));
   return rows.map((r) => ({
     id: r.id,
-    name: r.id === AUTO_ID ? `Agent402 auto (routed, ${priceLabel(r.priceUsd)}/call)` : `${r.id} (${priceLabel(r.priceUsd)}/call)`,
+    name: r.id === AUTO_ID ? `Agent402 auto (routed, ${priceLabel(r.priceUsd)}/call)` : r.metered ? `${r.id} (metered, from ${priceLabel(r.priceUsd)}/call)` : `${r.id} (${priceLabel(r.priceUsd)}/call)`,
     reasoning: false,
     input: ["text"],
     // Flat per-call billing: OpenClaw's per-token cost display does not apply.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent402-openclaw",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "OpenClaw model provider for Agent402: auto-routed and explicit LLM models at a flat per-call price, paid by card (prepaid credits key) or in USDC over x402 through a local proxy. Zero dependencies; x402 wallet payment is an optional peer.",
   "type": "module",
   "main": "index.js",

package/proxy.js

@@ -34,10 +34,10 @@ export const DEFAULT_UPSTREAM = "https://agent402.tools";
 export const PKG_VERSION = JSON.parse(readFileSync(new URL("./package.json", import.meta.url), "utf8")).version;
 const MAX_BODY = 2 * 1024 * 1024;
 
-export async function loadRoutes(upstream, fetchImpl = fetch) {
+export async function loadRoutes(upstream, fetchImpl = fetch, { pricing = "metered" } = {}) {
   const r = await fetchImpl(`${upstream}/v1/models`, { headers: { accept: "application/json" }, signal: AbortSignal.timeout(15_000) });
   if (!r.ok) throw new Error(`GET /v1/models -> HTTP ${r.status}`);
-  return routesFromCatalog(await r.json());
+  return routesFromCatalog(await r.json(), { pricing });
 }
 
 function readBody(req, limit = MAX_BODY) {
@@ -63,14 +63,16 @@ const json = (res, status, obj, headers = {}) => {
  * @param {number} [o.port]          0 = ephemeral
  * @param {string} [o.host]          default 127.0.0.1 (loopback only: anyone who can reach the port spends your key)
  * @param {Map} [o.routes]           pre-loaded routes (tests); else loaded from upstream
+ * @param {"metered"|"flat"} [o.pricing]  metered (default): explicit models pay per-request quotes; flat: home tiers
  * @param {(msg:string)=>void} [o.log]
  */
-export async function startProxy({ upstream = DEFAULT_UPSTREAM, creditsKey = null, payFetch = null, fetch: fetchImpl = fetch, port = 0, host = "127.0.0.1", routes = null, log = () => {} } = {}) {
+export async function startProxy({ upstream = DEFAULT_UPSTREAM, creditsKey = null, payFetch = null, fetch: fetchImpl = fetch, port = 0, host = "127.0.0.1", routes = null, pricing = "metered", log = () => {} } = {}) {
   upstream = stripTrailingSlashes(upstream);
+  pricing = pricing === "flat" ? "flat" : "metered";
   const key = typeof creditsKey === "string" && /^a402_[A-Za-z0-9_-]{16,80}$/.test(creditsKey) ? creditsKey : null;
   const paid = key ? fetchImpl : payFetch;
   const mode = key ? "credits" : payFetch ? "x402" : "unpaid";
-  let table = routes || await loadRoutes(upstream, fetchImpl);
+  let table = routes || await loadRoutes(upstream, fetchImpl, { pricing });
   const stats = { requests: 0, forwarded: 0, errors: 0, startedAt: new Date().toISOString() };
 
   const server = createServer(async (req, res) => {
@@ -85,10 +87,10 @@ export async function startProxy({ upstream = DEFAULT_UPSTREAM, creditsKey = nul
         return json(res, 403, { error: { message: `Host "${hostName.slice(0, 64)}" is not loopback; refused.`, type: "forbidden" } });
       }
       if (req.method === "GET" && url.pathname === "/health") {
-        return json(res, 200, { ok: true, upstream, mode, models: table.size, stats });
+        return json(res, 200, { ok: true, upstream, mode, pricing, models: table.size, stats });
       }
       if (req.method === "GET" && url.pathname === "/v1/models") {
-        return json(res, 200, { object: "list", data: [...table.values()].filter((r) => !r.stealth).map((r) => ({ id: r.id, object: "model", owned_by: "agent402", agent402: { endpoint: r.endpoint, priceUsd: r.priceUsd, tier: r.tier } })) });
+        return json(res, 200, { object: "list", data: [...table.values()].filter((r) => !r.stealth).map((r) => ({ id: r.id, object: "model", owned_by: "agent402", agent402: { endpoint: r.endpoint, priceUsd: r.priceUsd, tier: r.tier, metered: !!r.metered } })) });
       }
       if (req.method === "POST" && url.pathname === "/v1/chat/completions") {
         const raw = await readBody(req);
@@ -130,11 +132,11 @@ export async function startProxy({ upstream = DEFAULT_UPSTREAM, creditsKey = nul
   await new Promise((resolve, reject) => { server.once("error", reject); server.listen(port, host, resolve); });
   const actualPort = server.address().port;
   const baseUrl = `http://${host}:${actualPort}`;
-  log(`[agent402-openclaw] proxy on ${baseUrl}/v1 -> ${upstream} (${mode}, ${table.size} models)`);
+  log(`[agent402-openclaw] proxy on ${baseUrl}/v1 -> ${upstream} (${mode}, ${pricing} pricing, ${table.size} models)`);
   return {
-    baseUrl, port: actualPort, mode, upstream,
+    baseUrl, port: actualPort, mode, upstream, pricing,
     stats: () => ({ ...stats }),
-    refreshModels: async () => { table = await loadRoutes(upstream, fetchImpl); return table.size; },
+    refreshModels: async () => { table = await loadRoutes(upstream, fetchImpl, { pricing }); return table.size; },
     close: () => new Promise((resolve) => server.close(() => resolve())),
   };
 }