Skip to main content
Open source

multi-clawd

One Claude is never enough

An OpenClaw plugin that registers your extra Claude Code logins as first-class CLI backends. When your main account hits a usage limit, failover rolls to your second account on the same model — instead of dropping to a smaller one — with every tool, skill, and MCP bridge intact.

View on GitHubInstall
multi-clawd — a cyberpunk lobster with two extra robotic claws

Features

What it does.

First-Class Backends

Every account registers as a real CLI backend (claw2/…, claw3/…) — resolvable in model refs, fallback chains, and per-agent overrides. No API keys, no baseUrl hacks.

Same-Model Failover

Exhaust the account, not the model. A usage limit rolls to your next login on the same model — tier drops become the last resort instead of the default.

Full Harness on Every Hop

Each backend is a genuine Claude Code subprocess: native tools, skills, the OpenClaw MCP bridge, and native compaction all survive the hop across accounts.

Token Hygiene

Setup-tokens are read at launch and passed only through the child process environment. Never committed, never logged, never in your config in plain sight.

Self-Healing Registration

If the plugin loader hands over an empty config block, registration re-reads the resolved runtime config directly — a flaky pass can't silently disable your failover.

Isolated Logins

Each account lives in its own CLAUDE_CONFIG_DIR with its own token file, keeping sessions, settings, and auth cleanly separated per login.

How it works

4 simple steps.

1

Install the Plugin

Clone from GitHub, npm install and build, then openclaw plugins install. One TypeScript plugin, MIT licensed. ClawHub install is landing shortly.

2

Capture the Second Login

Give the account an isolated config dir and capture its Claude Code setup-token into it — one claude setup-token command per account.

3

Configure Accounts

List each account in the plugin config. Every account becomes a provider prefix like claw2/ with the full Claude model catalog behind it.

4

Slot Into the Chain

Add claw2/… to your fallback chain and restart the gateway. Limits now roll across your accounts before any model-tier drop.

One chain, all your capacity

Your fallback chain stops meaning “smaller model” and starts meaning “next account”.

openclaw.json
"agents": { "defaults": { "model": {
  "primary": "claude-cli/claude-fable-5",   // main login
  "fallbacks": [
    "claw2/claude-fable-5",                 // 2nd login — same model
    "claw3/claude-fable-5",                 // 3rd login? go on then
    "anthropic/claude-opus-4-8"             // only NOW drop a tier
  ]
} } }

4

Claws

0

API keys required

100%

Harness intact

MIT

Licence

Frequently Asked Questions

What is multi-clawd?+
multi-clawd is an open-source OpenClaw plugin that registers additional Claude Code logins as first-class CLI backends. It lets your failover chain pool multiple Claude accounts — same model, next account — before ever dropping down a model tier.
Why does this need a plugin at all?+
OpenClaw's bundled claude-cli backend drives one Claude Code subprocess on a single login, and it won't hot-swap accounts mid-run. Plain config can't fix that: user-defined providers are treated as API providers that demand a baseUrl and API key. Plugin-registered backends get the same first-class treatment as the bundled one — that's the supported route, and the repo's DESIGN.md documents the dead ends so you don't have to rediscover them.
Does failover keep my skills and MCP tools?+
Yes — that's the whole point. Each account's backend is a genuine Claude Code subprocess with the OpenClaw MCP bridge, native tools, and skills attached. Stepping across accounts doesn't cost you the harness.
Is this within my provider's terms?+
multi-clawd is built for accounts you own. It runs the official Claude Code CLI under each login — no API spoofing, no shared credentials. You're responsible for using it within your provider's terms of service.
How many accounts can I add?+
As many as you own. Each entry in the accounts array becomes its own backend and provider prefix — claw2, claw3, and onwards.
What does it cost?+
Nothing. multi-clawd is MIT licensed and open source. If it saves your fleet from a single mid-task tier drop, it's paid for itself.

Grow an extra claw

Stop letting your second Claude account sit idle. Install multi-clawd and make your failover chain pool the capacity you already pay for.

Get Started on GitHub