ZeroAPI Router

ZeroAPI is an OpenClaw gateway plugin for transparent, subscription-aware model routing.

It reads your local OpenClaw model and auth-profile configuration, classifies each eligible turn with deterministic rules, and can return a per-turn model/provider override. There is no extra router LLM call in the hot path.

What It Does

• Routes eligible OpenClaw turns across configured subscription providers.
• Chooses models from the user's zeroapi-config.json policy.
• Can select a matching auth profile when the configured account inventory includes one.
• Preserves fixed-model specialist agents unless the policy explicitly opts them into routing.
• Writes local routing and advisory state under the OpenClaw state directory.

What It Reads

• ~/.openclaw/zeroapi-config.json
• the resolved OpenClaw configuration supplied by the host plugin API
• OpenClaw auth-profile inventory files
• OpenClaw agent/workspace metadata needed to identify the current agent/session

ZeroAPI does not read provider dashboards, live remaining quota, billing counters, OAuth token values, or private API keys.

What It Writes

• local routing logs
• zeroapi-advisories.json when new supported providers/accounts are detected outside the current policy
• bounded advisory delivery metadata so the same advisory is not repeated every reply
• best-effort OpenClaw session auth-profile override state when a routed account has an auth profile

All writes are intended to stay inside the OpenClaw state directory.

Session account pins use OpenClaw's public session-store API, including a custom session store when configured. Current hosts store these entries in SQLite; ZeroAPI does not write SQLite tables or legacy session JSON directly. The native before_model_resolve contract consumes model/provider overrides only. ZeroAPI's callback retains an optional authProfileOverride extension for compatible hosts, but the unmodified native runner drops it. A saved account pin therefore does not guarantee same-turn auth-profile selection on an unmodified host.

OpenClaw's service lifecycle starts and stops the subscription advisory monitor. CLI metadata and setup registration do not start it. Discovery and replacement runtime registries can each register their hooks without a process-global flag suppressing the replacement. Image attachment metadata supplied by the host is included when choosing a model with vision support.

Channel Advisories

When ZeroAPI detects a supported provider or account that is not yet in the policy, it can prepend one compact notice to the next outgoing reply in each conversation. This is explicit product behavior so the operator knows to rerun /zeroapi.

Disable channel notices with:

{
  "channel_advisories_enabled": false
}

or:

ZEROAPI_CHANNEL_ADVISORIES=false

The advisory file and logs can still be used for operators who do not want channel-visible notices.

Install Safely

Install only from the source-linked package:

openclaw plugins install clawhub:zeroapi@3.11.3

Verify the package source points to:

• repo: dorukardahan/ZeroAPI
• source path: plugin
• source tag or commit matching the intended release

Configure

Run /zeroapi in an OpenClaw channel, or use the repo-local setup flow if you are operating from a shell. The generated policy should describe only the subscriptions and accounts you want ZeroAPI to use.