* fix(subq): publish SubQ Snap through the hosted model catalog The catalog publisher reads only `modelCatalog.providers`. SubQ declared its Decision row through the legacy `decisionModels` field, so the hosted v3 catalog never carried it. Declare the same row canonically; the normalized manifest catalog is unchanged, and the codec reads its id and limits from it. Co-authored-by: obviyus <22031114+obviyus@users.noreply.github.com> * fix(decisions): serve Fastino and Perplexity Decision rows from the hosted catalog Both manifests declared `discovery: runtime`, but neither plugin registers a catalog hook and each adapter accepts only its one manifest model. The Gateway drops hosted rows for runtime providers, so the published rows never reached the Decision picker. Leave discovery unset, as Celeris and Nace do. Co-authored-by: obviyus <22031114+obviyus@users.noreply.github.com> * fix(decisions): serve SubQ, Fastino and Perplexity Decision models from the hosted catalog OpenClaw-Publication: 922df7ed-e18d-4bfb-86a5-41278c66a746 * test(catalog): read Decision coverage through typed manifest and v3 parsers Co-authored-by: obviyus <22031114+obviyus@users.noreply.github.com> * Publish openclaw/catalog-decision-providers OpenClaw-Publication: cf228831-c506-4fcc-b893-4cd8e413037f * test(catalog): consolidate the hosted Decision coverage check Co-authored-by: obviyus <22031114+obviyus@users.noreply.github.com> * Publish openclaw/catalog-decision-providers OpenClaw-Publication: 9d3c601b-5e7c-478c-bc06-239085710210 * test(catalog): pass an explicit join separator Co-authored-by: obviyus <22031114+obviyus@users.noreply.github.com> * Publish openclaw/catalog-decision-providers OpenClaw-Publication: b39b08fe-6fdb-4e02-947d-036a7f080ca4 * test(catalog): allocate the hosted Decision coverage test lines Co-authored-by: obviyus <22031114+obviyus@users.noreply.github.com> * Publish openclaw/catalog-decision-providers OpenClaw-Publication: e9ffde29-4678-4e69-bc9e-24ded388ddad * test(catalog): drop the test-lines allocation now that main has slack Co-authored-by: obviyus <22031114+obviyus@users.noreply.github.com> * Publish openclaw/catalog-decision-providers OpenClaw-Publication: ef6eb4a3-5c1e-4ce6-bb71-842d04cd2433 * fix(subq): retire Snap preview instead of publishing it SubQ retired subq-snap-preview on 2026-11-11 and reroutes it to another model. Remove the row, declare the retirement as a manifest suppression, and send the selected model id instead of a pinned constant. The adapter refuses retired ids before any request, and doctor --fix clears a retired decisionModel. Suppression ownership now includes Decision-only providers, matching manifest catalog normalization. Co-authored-by: obviyus <22031114+obviyus@users.noreply.github.com> * fix(config): leave retired model refs to Doctor instead of rejecting config Unconditional retirement suppressions would stop the Gateway at startup. Runtime already refuses retired refs and doctor --fix repairs them. Co-authored-by: obviyus <22031114+obviyus@users.noreply.github.com> * test(catalog): consolidate retired Decision model coverage Co-authored-by: obviyus <22031114+obviyus@users.noreply.github.com> * Publish openclaw/catalog-decision-providers OpenClaw-Publication: b988323a-0316-4436-b0f4-b443ab7fc4ae * test(catalog): assert hosted Decision rows for every fixed-list provider Co-authored-by: obviyus <22031114+obviyus@users.noreply.github.com> * Publish openclaw/catalog-decision-providers OpenClaw-Publication: 493b0063-0e49-4085-a21f-c44136e2484d * Publish openclaw/catalog-decision-providers OpenClaw-Publication: 1d0732a9-7956-416e-b6e6-dd21369f2d0b --------- Co-authored-by: obviyus <22031114+obviyus@users.noreply.github.com>
6.3 KiB
| summary | title | read_when | ||
|---|---|---|---|---|
| Use SubQ Snap for typed decisions, not chat completions | SubQ |
|
SubQ
The subq plugin connects the optional decision model role
to the SubQ Decisions API, which hosts SubQ Snap models for Boolean judgments,
choices, and rubric scores. It does not replace your chat model or provide text
generation or agent tool calling.
Install and configure
This is an external plugin candidate; package publication is pending. Until a
supporting release publishes it, use a source checkout containing
extensions/subq, install its dependencies, and build OpenClaw. The packaged
plugin declares OpenClaw and Plugin API 2026.10.3 or newer.
After publication, install it with openclaw plugins install @openclaw/subq.
Create a SubQ API key at console.subq.ai and store it
in Settings → Secrets. Merge this configuration with your existing settings;
preserve other entries in plugins.allow:
{
plugins: {
allow: ["subq"],
entries: {
subq: {
enabled: true,
config: {
apiKey: { source: "store", provider: "default", id: "SUBQ_API_KEY" },
},
},
},
},
}
The plugin is disabled by default. Enabling it does not select a model, schedule
work, or change your primary model. Select a SubQ model in the Decision picker when
the catalog lists one. An individual agent can set its own decisionModel; an empty
override disables that role for the agent.
Credentials must be SecretRefs, not plaintext. Environment, file, and exec
SecretRefs are also supported through the host's secrets system.
The plugin reads the prepared credential for each request; it does not read
ambient SUBQ_API_KEY itself or retain a previous key after a secret refresh.
Do not paste API keys in chat.
Use
With the plugin configured, decision_evaluate sends only the supplied state
and questions to SubQ. For example:
{
"state": { "ticket": "Checkout is unavailable for all customers." },
"questions": {
"escalate": {
"type": "boolean",
"instructions": "Does this require human incident response?",
"criteria": {
"true": "A widespread service outage",
"false": "A routine support question"
}
}
}
}
The Boolean result preserves the vendor's probability of yes, rather than thresholding it. Choice results preserve every alternative's probability; Score results preserve fractional zero-based rubric positions and their index-aligned probabilities. Optional confidence is vendor-specific, not a probability that the model is correct. Results never authorize external actions. Automatic experimental consumers still require the separate Decision assistance opt-in.
API and limits
The adapter targets POST https://api.subq.ai/v1/systemone with Bearer auth and
sends the selected Decision model ID. It translates OpenClaw's boolean questions to
the API's noul type. It does not route Snap through OpenAI chat completions;
the separate subq-preview chat model is not part of this integration.
According to SubQ's public Decisions API documentation, checked November 12, 2026:
- Requests support 1–128 questions; question IDs are at most 100 characters.
- Choice questions support 2–255 alternatives; Score questions support 2–10 levels.
- Output tokens are free and reported as zero. Per-model prices and context windows are on the Models page.
- The vendor API supports up to four PNG, JPEG, or WebP images, each up to 4 MiB decoded and 8 MiB decoded total, within a 13 MiB request body. It does not accept video.
This V1 adapter is text/JSON only. It does not expose the vendor API's image input, fetch URLs, or reinterpret base64 in state as an image. Its host's one-MiB input limit, 20,000 JSON-node limit, depth 32, and at-most-30-second deadline still apply. Do not assume the entire advertised context window fits these bounds. Use text, an object, or an array for state; null state is not part of the vendor's documented request contract. Oversized/unsupported requests are rejected, not split or truncated. The server enforces its token limit, including requests near that limit; JSON bytes are not a token estimate.
Hosted evaluations send evidence to SubQ and may incur charges. The plugin never
retries a paid call automatically. Invalid credentials/access return
authentication; input rejection returns unsupported-input; rate limits return
rate-limited. Insufficient credit (HTTP 402) and service/network failures return
transport. Check credits and model access in the console. Error response bodies
are not exposed because they may contain supplied evidence or credentials.
Sources and verification
The adapter has synthetic HTTP-boundary tests for the documented wire format,
limits, errors, cancellation, and secret refresh. Authenticated live inference
has not been verified; a SubQ account with model access and credits is required.
Developers can run pnpm test:live -- extensions/subq/src/runtime.live.test.ts
with a protected SUBQ_API_KEY and the SubQ model ID in SUBQ_DECISION_MODEL. The live runner opts in
with OPENCLAW_LIVE_TEST=1; the test sends only its fixed synthetic example
and makes one paid request.
Vendor benchmark and latency claims are not OpenClaw validation results.