@t54-labs/clawcredit-blockrun-sdk

SDK + standalone OpenAI-compatible gateway for BlockRun inference paid via claw.credit SDK.

This package provides:

• SDK helpers (createClawCreditFetch, startGateway)
• a standalone gateway service (POST /v1/chat/completions)
• a setup script for OpenClaw integration

Why this exists

• Keep payment integration as a standalone t54-labs solution
• Let ClawRouter (or any other client) consume it as a low-coupling backend
• Standardize on official claw.credit SDK flow

Quick start

npm install
npm run build

export CLAWCREDIT_API_TOKEN=claw_xxx
export CLAWCREDIT_CHAIN=BASE
export CLAWCREDIT_ASSET=USDC

node dist/cli.js
# listening on http://127.0.0.1:3402

SDK usage

import { startGateway } from "@t54-labs/clawcredit-blockrun-sdk";

const gateway = await startGateway({
  port: 3402,
  clawCredit: {
    apiToken: process.env.CLAWCREDIT_API_TOKEN!,
    chain: "BASE",
    asset: "USDC",
  },
});

OpenClaw one-command setup

Use the helper script to wire this gateway into OpenClaw as a standalone provider:

bash scripts/setup-openclaw-clawcredit-gateway.sh --token claw_xxx

This will:

• build/start the standalone gateway in background
• fetch latest real model IDs from https://blockrun.ai/api/v1/models
• patch OpenClaw provider config (blockruncc -> http://127.0.0.1:3402/v1)
• restart OpenClaw gateway
• set active model to blockruncc/openai/gpt-4o (default)

Dry-run first:

bash scripts/setup-openclaw-clawcredit-gateway.sh --token claw_xxx --dry-run

Then call:

curl -sS http://127.0.0.1:3402/v1/chat/completions \
  -H 'Content-Type: application/json' \
  -d '{
    "model":"openai/gpt-4o",
    "messages":[{"role":"user","content":"hi"}],
    "max_tokens":64
  }'

Environment variables

• CLAWCREDIT_API_TOKEN (required)
• CLAWCREDIT_API_BASE (default: https://api.claw.credit)
• CLAWCREDIT_CHAIN (default: BASE)
• CLAWCREDIT_ASSET (default: USDC on BASE)
• CLAWCREDIT_AGENT (optional)
• CLAWCREDIT_AGENT_ID (optional)
• CLAWCREDIT_DEFAULT_AMOUNT_USD (default: 0.1)
• BLOCKRUN_API_BASE (default: https://blockrun.ai/api)
• HOST (default: 127.0.0.1)
• PORT / GATEWAY_PORT (default: 3402)

Supported models

This gateway syncs model IDs from BLOCKRUN_API_BASE/v1/models (no meta models). Examples include:

• openai/gpt-4o
• openai/gpt-5.2
• anthropic/claude-opus-4.5
• anthropic/claude-sonnet-4
• google/gemini-3-pro-preview
• moonshot/kimi-k2.5

List current synced models in OpenClaw:

openclaw models show | rg '^  blockruncc/'

Endpoints

• GET /health
• POST /v1/chat/completions

Development

npm run typecheck
npm run test
npm run build