LowRouter provider for OpenClaw

Adds LowRouter as a model provider in OpenClaw.

LowRouter is an OpenAI-compatible router run from the EU. An auto/<creator>/<model> ID can be served by several European or global hosts. LowRouter prefers low-carbon regions and fails over between them. Maintained by the LowRouter team.

Install

Requires OpenClaw 2026.10.2 or newer.

openclaw plugins install clawhub:@lowrouter/openclaw-provider
openclaw gateway restart

Get a key at lowrouter.ai/app/keys, then either run onboarding or export it before starting OpenClaw:

openclaw onboard --auth-choice lowrouter-api-key
# or
export LOWROUTER_API_KEY=sk-lr-...

Pick a model:

openclaw models list --refresh --provider lowrouter
openclaw models set lowrouter/auto/mistralai/mistral-large-2512

Use openclaw models set, not openclaw config set agents.defaults.model.primary. The config command validates against the bundled list only and can reject a model that discovery found.

Models

With a key, the plugin reads GET /v1/models?currency=usd and caches it for five minutes. The picker lists:

• auto/<creator>/<model> IDs and your account's alias/<name> models;
• chat models with tool calling only, since OpenClaw acts through tools.

Pinned routes (<host>/<creator>/<model>) and jurisdiction-scoped IDs (auto/<creator>/<model>/eu) stay out of the list. They still work when you type them, for example openclaw models set lowrouter/auto/mistralai/mistral-large-2512/eu.

Context windows, output limits, input types and reasoning support come from /v1/models. A model without a published context window gets 32,768 tokens, so OpenClaw compacts early rather than sending a prompt the model rejects. A model without an output limit gets OpenClaw's 8,192 default.

Without a key or network, OpenClaw uses the snapshot bundled with the release. The snapshot is generated from the same endpoint by npm run gen:catalog; nothing in it is written by hand.

Cost

LowRouter bills in euros, for the route that served the request. OpenClaw tracks cost in US dollars, so the plugin reads USD prices (?currency=usd). An auto/ model has several routes at different prices, and the plugin shows the dearest one. OpenClaw's cost estimate can run high, never low. What you were charged is in each response's usage.cost (EUR) and on lowrouter.ai/app.

Development

npm install
npm run build
npm test
npm pack --dry-run

Live tests need a key and explicit opt-in. They run catalog discovery, one streamed completion and one tool call on the default model (LOWROUTER_LIVE_MODELS=a,b picks others):

OPENCLAW_LIVE_TEST=1 LOWROUTER_LIVE_TEST=1 LOWROUTER_API_KEY=sk-lr-... npm run test:live

Before a release, refresh the bundled snapshot and validate the package:

LOWROUTER_API_KEY=sk-lr-... npm run gen:catalog
npx clawhub package validate .
npx clawhub package publish . --dry-run

License

Apache-2.0