Tools
HyperRouter Openclaw
OpenClaw provider plugin for Hyper Router — @hyperrouter/openclaw-provider npm package
Install
npm install -g
README
# @hyperrouter/openclaw-provider
OpenClaw plugin that adds [Hyper Router](https://hyperrouter.ai) as a provider, so you can route OpenClaw's model calls through Hyper Router's OpenAI-compatible gateway.
## Why
OpenClaw bundles a small set of provider extensions (anthropic, openai, openrouter, ...). Hyper Router isn't bundled, so without this plugin OpenClaw can't recognize `hyperrouter/<author>/<slug>` model refs.
Once the plugin is installed and your `HYPERROUTER_API_KEY` is wired in, every call flows: OpenClaw → Hyper Router → upstream provider. The default primary model is `hyperrouter/auto` (HR auto-router picks per request); override to a specific slug like `hyperrouter/anthropic/claude-sonnet-4.6` in `~/.openclaw/openclaw.json` if you want.
## Install
Pick one of two paths.
**A — One-line installer (recommended)**. Installs the plugin globally, asks for your hr-key, and writes `~/.openclaw/openclaw.json` for you:
```bash
curl -fsSL https://hyperrouter.ai/install/openclaw.sh | bash
```
**B — Manual**. Install the plugin and wire credentials yourself:
```bash
npm install -g github:HyperRouterAI/HyperRouter-openclaw
openclaw onboard --auth-choice apiKey --token-provider hyperrouter --token "$HYPERROUTER_API_KEY"
```
The plugin auto-registers via the `openclaw.extensions` field in its `package.json` — OpenClaw's plugin loader picks it up the next time you run `openclaw`. No manual edits to `openclaw.json` are required for registration.
## What you get
- `hyperrouter` provider registered with OpenClaw
- API key flow: `HYPERROUTER_API_KEY` env var or `--hyperrouter-api-key` flag
- Dynamic model resolution for any `hyperrouter/<author>/<slug>` model ID
- Routing, cost cap, BYOK fallback, multi-provider observability — all handled server-side by Hyper Router
## Upstream plan
We intend to upstream this provider into OpenClaw core so it ships out-of-the-box like the `openrouter` extension does. Until that PR lands, the `github:HyperRouterAI/HyperRouter-openclaw` install above (or the one-line installer) is the sideload path. We will publish to npm and update this README the same day a public registry release goes out.
## License
MIT
tools
Comments
Sign in to leave a comment