ClawRouter 🦞 — One key, many upstreams.

ClawRouter is a provider-neutral API gateway for OpenClaw deployments. It routes policy-scoped credentials across model and tool providers while enforcing access, revocation, budgets, request retention, and metered usage.

Install

ClawRouter is distributed from source. Local development requires Node.js 24 or newer and the pnpm version declared in package.json.

git clone https://github.com/openclaw/clawrouter.git
cd clawrouter
corepack enable
pnpm install --frozen-lockfile

For a complete service without a Cloudflare account, use the Docker self-hosting profile. It requires Docker with Compose and OpenSSL.

Quick start

Run the local end-to-end Worker smoke:

pnpm worker:e2e

The smoke starts a local Worker and fixture upstream, exercises discovery, authentication, routing, budgets, failover, retention, usage, and admin paths, then removes its temporary state.

Routing

Clients authenticate with one policy-scoped clawrouter- credential. The selected policy controls which providers and models are visible, how upstream grants are…