Skip to content

Docs: add OpenRouter Fusion model guidance #92984

Description

@sallyom

Summary

Track docs work for OpenRouter Fusion models.

Scope

  • Document how to configure and use OpenRouter Fusion models in OpenClaw.
  • Clarify model id examples and known behavior differences from regular OpenRouter models.
  • Link from the OpenRouter provider docs where users would expect to find it.

Agent Transcript

Redacted codex session transcript
source: [LOCAL_SESSION]
redaction: local paths, emails, phone-shaped strings, token-shaped strings, auth headers, auth query params
omitted: raw tool outputs, system/developer prompts, local paths, secrets, browser/session/auth details
stats: {"agent":"codex","entries":7,"user":3,"assistant":3,"toolCalls":23,"toolOutputsDropped":22,"web":0,"redactions":0,"omittedUnsafe":0,"rawEntries":16}

[user]
I'm currently working with another codex session to add openrouter/fusion docs. ptal at open issues - i don't see any wrt openrouter fusion models, do you? If not, should we add an issue so others know i'm working on this.

[assistant]
I’ll use the OpenClaw PR maintainer workflow here because this is OpenClaw issue triage. I’ll check the live issue state and search for OpenRouter/Fusion-related items before recommending whether to open a coordination issue.

The checkout is already dirty on an `openrouter-fusion-docs` branch, with edits in `docs/providers/openrouter.md` and one OpenRouter test. I’ll avoid changing files and use read-only issue search.

I fetched `origin/main` so the maintainer workflow search uses current repo guidance, without rebasing or touching the branch. Next I’m checking the issue archive first, then I’ll verify live GitHub search results.

The local gitcrawl store is available but stale: last sync was `2026-05-21T18:15:03Z`. I’ll treat it as a broad cache only and rely on live `gh`/GitHub verification for the final answer.

Initial searches show no live open issue matching `openrouter fusion` or `fusion models`; the only cache hit for “fusion models” is unrelated embedding memory issue #63990. I’m broadening to OpenRouter-only and comment searches to catch differently worded threads.

The broader OpenRouter searches found related model-routing/provider issues, but still nothing specifically tracking Fusion docs. I’m doing one PR search too, so we don’t open a duplicate coordination thread if someone already has a PR up.

I don’t see an open issue specifically for OpenRouter Fusion model docs. Related-but-not-duplicate items include #10687 dynamic model discovery, #7006 `openrouter/auto` attribution/cost, #88616 OpenRouter `session_id`, #91504 OpenRouter image models, and #92769 MiniMax/OpenRouter reasoning handling.

[user]
we don't need the Status - I will assign this issue to myself once it's created.

[assistant]
Understood. I’ll create the tracking issue without the Status section, then leave assignment to you. First I’m checking the issue-creation transcript guidance because this repo requires that before opening GitHub issues.

The transcript rule says to include one only if there’s a safe, relevant local session and you approve it. I’m checking for a matching session now; if none is suitable, I’ll create the issue with the clean body.

There is a high-confidence local session for this exact work, so I need one quick confirmation before creating the issue: include a redacted agent transcript in the issue body? It helps reviewers and can make the issue easier to prioritize; I can open a local preview first.

Found one live search hit, #63990, but it’s unrelated memory vector-fusion work, not OpenRouter Fusion docs.

I’m ready to create the issue without a Status section. One repo-required checkpoint: a relevant local session was found, so tell me whether to include a redacted agent transcript or create the issue without it.

[user]
sure include the transcript

[assistant]
I’ll render the redacted transcript, inspect the generated Markdown for safety/relevance, then create the GitHub issue with the docs scope and no Status section.

[tool summary]
7 read, 16 execute; raw tool outputs dropped: 22

Metadata

Metadata

Assignees

Labels

P3Low-priority cleanup, docs, polish, ergonomics, or speculative work.issue-rating: 🌊 off-meta tidepoolIssue quality rating does not apply to this item.maintainerMaintainer-authored PR

Type

No type

Fields

No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions