Releases: ekinnee/omniroute-openclaw
Release list
v2.2.0
OmniRoute OpenClaw v2.2.0
Minor release for @ekinnee/omniroute-provider.
Added
- Add image editing through OmniRoute
POST /v1/images/editsfor OmniRoute
v3.8.11 and newer. Edits accept one reference image, send it as a JSON data
URL, and require an explicitly selected edit-capable model.
Fixed
- Exclude chat catalog rows that omit required context or output limits instead
of allowing OpenClaw to fill the gaps with synthetic sizing metadata. - Preserve an explicit
capabilities.tool_calling: falseso OpenClaw does not
send tools to models that advertise no tool support. - Bound provider-usage response bodies to 32 KiB, cancel oversized streams, and
normalize body-read failures to unavailable usage snapshots. - Reject target TLS overrides combined with explicit-proxy mode before a
plugin-owned request because the supported OpenClaw transport cannot preserve
those target settings through an explicit proxy.
Maintenance
- Harden release publication, test gating, and pull-request labeling.
- Add contributor guidance and update the roadmap for OpenClaw's pending
asynchronous embedding-batch contract. - Update Vitest to 4.1.11.
Compatibility
- Stable compatibility floor remains OpenClaw
2026.7.1. peerDependencies.openclawandopenclaw.compat.pluginApiremain
>=2026.7.1-0.- No configuration migration is required.
- Image editing requires OmniRoute v3.8.11 or newer. Image generation and the
plugin's other capabilities retain their existing OmniRoute requirements.
Known limitations
- URL-only video results retain the existing host-compatibility limitation
tracked in #50.
Its safe repair remains blocked on the upstream media lifecycle contract. - Asynchronous embedding batches remain deferred until the merged OpenClaw SDK
contract ships in a stable release, as tracked in
#58.
Verification
The exact release candidate is validated by the repository Test and Upstream
Compatibility workflows, plus local package and Plugin Inspector validation
before publication.
Included merged changes: #45,
#46,
#47,
#51,
#52,
#55,
#56,
#57,
#59, and
#60.
v2.1.4
OmniRoute OpenClaw v2.1.4
Patch release for @ekinnee/omniroute-provider.
Included
- Preserve OmniRoute web-search freshness and result content when projecting
responses through OpenClaw. - Reject malformed embedding responses with invalid vector indices before they
can create inconsistent vector indexes. - Bound upstream JSON response bodies to prevent unbounded plugin memory use.
- Accept inline OmniRoute video artifacts as valid generation results.
- Mark OmniRoute as an external provider in the plugin registration metadata.
Compatibility
- Stable compatibility floor remains OpenClaw
2026.7.1. peerDependencies.openclawandopenclaw.compat.pluginApiremain
>=2026.7.1-0.- No configuration migration is required.
Verification
The exact release candidate is validated by the repository Test and Upstream
Compatibility workflows, plus local package validation before publication.
v2.1.3
OmniRoute OpenClaw v2.1.3
Patch release for @ekinnee/omniroute-provider.
Included
- Hardened base URL resolution and live model-discovery transport.
- Reused host-owned authentication and cancellation behavior for web search,
including compatibility with the current OpenClaw beta exports. - Corrected the remote-provider quickstart documentation.
- Made the declared OpenClaw build identity and prerelease-aware peer/API
contract truthful and continuously checked against the packed artifact. - Added floor/latest/beta compatibility coverage with durable probe summaries.
- Updated the README and support roadmap with the current release and provider
capability scope.
Compatibility
- Stable compatibility floor remains OpenClaw
2026.7.1. peerDependencies.openclawandopenclaw.compat.pluginApiare
>=2026.7.1-0so same-floor prereleases resolve correctly.- No configuration migration is required.
- No production runtime behavior or provider lifecycle owner was changed by
the compatibility repair.
Verification
The release candidate was tested against a disposable packaged OpenClaw host
and the floor/latest/beta packed-artifact matrix. See the repository-hosted
compatibility proof
and host canary proof,
plus the release-preparation PR
and workflow-lint repair PR.
The merged-main compatibility dispatch 32995482195
passed all three rows. The packed artifact SHA-256 is
119922eb5b66547c91d88369e45986ff80571fdd6822abb685ef166cdc54da1d.
ClawHub published 2.1.3 from refs/tags/v2.1.3 at commit
b26210ed4d1a8c6cf59f13cf42bf936804ccc6f5. Its registry-repacked public
artifact verifies at SHA-256
2d45def08cc3294255f22cb2daadfc257cd6d4dfa62266a9a9bde5f33d181adc.
The published package is available at
ClawHub; readiness
reports only the expected official community-channel blocker.
v2.1.2
What's changed
- Preserve each discovered model's advertised reasoning-effort subset.
- Keep unsupported OpenClaw thinking levels disabled instead of falling back to canonical levels when
effort_tiersis present. - Normalize and deduplicate valid effort tiers while ignoring malformed or unknown values.
- Verify exact subset admission and OpenAI-compatible request construction.
This fixes models such as DeepSeek V4 Flash advertising off, low, medium, and xhigh without incorrectly exposing high.
Included pull requests
Full changelog: v2.1.1...v2.1.2
v2.1.1
What's Changed
- fix: use configured key for catalog discovery by @ekinnee in #7
- ci: harden the plugin test workflow by @ekinnee in #8
- docs: correct the plugin entry helper note by @ekinnee in #9
- feat: report OmniRoute provider usage by @ekinnee in #10
- docs: expand OmniRoute provider capability roadmap by @ekinnee in #11
- ci: add GitHub issue intake and PR triage by @ekinnee in #18
- chore: prepare v2.1.1 release by @ekinnee in #19
Full Changelog: v2.1.0...v2.1.1
v2.1.0
OmniRoute Provider v2.1.0
This additive release provides a plugin-owned way to inspect the model metadata OmniRoute actually advertises while OpenClaw's catalog and WebChat capability surfaces continue to evolve.
Added
- Add the read-only
omniroute-catalog-auditexecutable. - Load the same effective OpenClaw configuration, agent-scoped credentials, base URL, request headers, proxy, TLS, and SSRF handling used by the plugin.
- Report advertised catalog metadata, invalid rows, duplicate IDs, and relevant metadata gaps without synthesizing capabilities or defaults.
- Redact URL credentials, query strings, fragments, and other sensitive connection details from audit output.
- Add weekly, manual, and pull-request packed-artifact compatibility checks against the published
openclaw@betapackage.
Corrected
- Make profile-backed catalog discovery and runtime credential resolution honor OpenClaw's configured authentication profile order.
Upgrade
No configuration migration is required from 2.0.0. Install or update through ClawHub, then run omniroute-catalog-audit --agent main when diagnosing catalog metadata. The command does not modify OpenClaw configuration or send an inference request.
Validation
- 57 unit and integration tests
- clean TypeScript build and workflow lint
- ClawHub package validation with zero issues or warnings
- exact packed-artifact registration checks against OpenClaw
2026.7.1and the publishedopenclaw@betapackage - independent release audit and diff review
v2.0.0
OmniRoute Provider v2.0.0
This major release makes the authenticated OmniRoute gateway the sole source of truth for model and combo discovery.
Breaking change
The plugin no longer injects or automatically selects omniroute/auto. Existing provider configuration is preserved, but users must select a model or combo returned by their authenticated OmniRoute /v1/models catalog. omniroute/auto remains usable only when that gateway actually advertises auto.
Added and changed
- Discover user-specific models and combos from authenticated
/v1/modelsresponses without a static fallback. - Preserve returned model and combo IDs exactly.
- Expose model-specific thinking controls from advertised capability metadata.
- Map an explicit thinking-off selection to
reasoning_effort: "none"while leaving session/configured defaults to OpenClaw. - Scope catalog caching to the normalized gateway URL, authentication profile, and a non-reversible credential fingerprint.
- Keep discovery credentials separate from runtime request credentials.
- Preserve existing onboarding configuration without fabricating a model or default selection.
- Harden release publishing with frozen dependency installs, tests, and tag/version validation.
Upgrade
After upgrading, authenticate to OmniRoute and run openclaw models list. Review primary, fallback, and manually configured omniroute/auto references, replacing them with an advertised omniroute/<model-id> or omniroute/<combo-id> when auto is not returned.
Validation
- 46 unit/integration tests
- clean frozen-lockfile build
- ClawHub package validation with zero issues or warnings
- packed-artifact imports against OpenClaw 2026.7.1 and 2026.8.1-beta.2
- authenticated live-catalog projection with no synthetic IDs
v1.0.2
Fix OpenClaw upstream provider contracts.
- Preserve configured onboarding model primaries.
- Reject insecure TLS overrides and honor explicit private-network denial.
- Avoid caching empty live catalogs.
- Preserve resolved embedding credentials over remote Authorization headers.
- Add regression coverage for all five fixes.
- Validated with pnpm test, pnpm build, ClawHub package validation, and GitHub Actions packaging.
v1.0.1
v1.0.0
What's Changed
- Web search: Added OmniRoute web search provider (
POST /v1/search) with query, count, freshness, country, and language support - Video generation: Added OmniRoute video generation provider (
POST /v1/videos/generations) with text-to-video support - ClawPack: Publish workflow now builds and uploads a ClawPack artifact instead of legacy ZIP
- Logging: Live discovery failures now log via
createSubsystemLoggerinstead of silent catch - Refactor: Extracted generic
fetchOmniRouteModelshelper, eliminated ~120 lines of duplication - Heuristic: Tightened reasoning detection from
id.startsWith(\"auto\")to exact match - Config: Removed
additionalProperties: falsefrom empty configSchema - Content-Type: Guarded header override to preserve user-configured values
- Docs: Updated README with web search and video gen configuration, clarified live discovery behavior