BlockRun
Get started
Integrations / ElizaOS

Add every BlockRun model to an ElizaOS character with one plugin

@blockrun/elizaos-plugin gives ElizaOS agents every BlockRun model through one plugin entry — no per-provider API keys, each call priced before it runs.

Get your agent on BlockRun Read the docs

How it works

ElizaOS agents are configured as characters with a plugins array. The BlockRun plugin exports one object to add there; it reads the wallet key from the character's settings or the environment and pays for each model call over x402 on Base. A default model is a setting, and any catalog id overrides it per call.

The plugin is community-maintained and published on npm with a peer dependency on ElizaOS core. It removes the per-lab key sprawl a multi-model character otherwise carries: one wallet, one setting, every model.

Behind it is the BlockRun catalog: 78 chat models plus image, video, music and speech generation, search, market data and multi-chain RPC, priced per call. 6 open-weight models are free and need no wallet.

Setup

1. Install

npm install @blockrun/elizaos-plugin

2. Wallet key

export BASE_CHAIN_WALLET_KEY=0x<your private key>

3. Register the plugin

import { blockrunPlugin } from '@blockrun/elizaos-plugin';
export const character = {
  name: 'MyAgent',
  plugins: [blockrunPlugin],
  settings: { BASE_CHAIN_WALLET_KEY: process.env.BASE_CHAIN_WALLET_KEY },
};

Questions

Which env var does the plugin read?
BASE_CHAIN_WALLET_KEY — from the character's settings first, then the environment.
Can I set a default model?
Yes, BLOCKRUN_DEFAULT_MODEL in the character settings; any catalog id works.

Related

Two ways to run this

Get an API key

Sign in, get a key, and call the same endpoints with usage billed to your account. For teams that want one invoice instead of one wallet.

Get an API key 

Or let your agent pay per call, in USDC

No account, no API key. Three steps, and the last one is the request this page is about.

  1. 01
    Point your agent at BlockRun

    Install ClawRouter, or add the BlockRun MCP server to Claude Code, Cursor, Codex or OpenClaw. Any OpenAI-compatible client works too — change the base URL, nothing else.

    curl -fsSL https://blockrun.ai/ClawRouter-update | bash
  2. 02
    Fund a wallet with USDC

    Send USDC to a wallet on Base or Solana. There is no account to create and no API key to issue: the wallet is the account, and it pays per call.

  3. 03
    Use BlockRun from ElizaOS

    The first call returns HTTP 402 with the exact price, your agent signs it, and the answer comes back. Payment settles on-chain; nothing is charged if the call fails.

    npm install @blockrun/elizaos-plugin
ClawRouter setup →How paying per call works →

Explore everything on BlockRun