openclaw/docs/plugins
Peter Steinberger 97bbbc2271
feat(agents): derive a provider-declared default utility model when unset (#103769)
* feat(agents): derive a provider-declared default utility model when unset

When agents.defaults.utilityModel is not set, utility tasks (titles, progress
narration) now use the primary provider's declared small model
(modelCatalog.providers.<id>.defaultUtilityModel: OpenAI -> gpt-5.6-luna,
Anthropic -> claude-haiku-4-5). Auth is inherent because derivation follows
the agent's primary provider. Setting utilityModel to an empty string
disables utility routing entirely; narration turns on automatically when a
default resolves and stays off otherwise.

Formatting/lint/tests verified on Testbox (oxfmt, oxlint, plugins:inventory,
docs:map, import-cycles, check:test-types, 4 test files).

* fix(ai): drop the temperature parameter for models that reject it

The GPT-5.6 family 400s on temperature via the Responses API (live-verified:
gpt-5.6-luna/-terra reject it; gpt-5.5 and gpt-5.4-mini/nano accept it).
supportsOpenAITemperature gates all three OpenAI payload builders, with a
catalog compat override (compat.supportsTemperature) declared for the 5.6
family in the openai manifest. Without this, utility tasks (titles,
narration) would fail once gpt-5.6-luna becomes the derived default.

Gates on Testbox: oxfmt, oxlint, plugins:inventory, import-cycles,
check:test-types, 6 test files. Live proof on Testbox: gpt-5.6-luna and
claude-haiku-4-5 one-shot completions succeed with temperature requested.

* fix(agents): carry the primary model's auth profile onto the derived utility default

A primary like openai/gpt-5.5@work previously reached utility tasks via the
profiled fallback; the derived default shares the provider, so its trailing
auth profile carries over instead of silently switching to default
credentials (Codex review). Gates on Testbox: oxfmt, check:test-types, tests.

* docs: realign the manifest provider-fields table after adding defaultUtilityModel
2026-07-10 17:40:11 +01:00
..
reference feat(qwen): add Token Plan (Team Edition) provider (#94419) 2026-07-09 22:07:01 +01:00
adding-capabilities.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
admin-http-rpc.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
agent-tools.md
architecture-internals.md feat(memory-wiki): isolate vaults per agent (#103349) 2026-07-10 05:19:13 +01:00
architecture.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
building-extensions.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
building-plugins.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
bundles.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
cli-backend-plugins.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
codex-computer-use.md fix(codex): prefer ChatGPT desktop resources (#103470) 2026-07-10 07:44:24 +01:00
codex-harness-reference.md fix(computer): prevent stale, replayed, and post-cancel desktop actions (#103422) 2026-07-10 06:47:56 +01:00
codex-harness-runtime.md fix(computer): prevent stale, replayed, and post-cancel desktop actions (#103422) 2026-07-10 06:47:56 +01:00
codex-harness.md fix(computer): prevent stale, replayed, and post-cancel desktop actions (#103422) 2026-07-10 06:47:56 +01:00
codex-native-plugins.md Let owner-operated Codex agents use connected account apps (#100973) 2026-07-06 12:31:45 -07:00
community.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
compatibility.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
copilot.md chore(repo): remove stale repository artifacts (#103152) 2026-07-10 05:28:12 +05:30
dependency-resolution.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
google-meet.md feat(providers): add Qwen 3.6 Flash and Gemini 3.1 Live (#102791) 2026-07-09 13:37:16 +01:00
hooks.md fix(cron): emit scheduled events after durable wake changes (#103647) 2026-07-10 17:39:23 +01:00
install-overrides.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
llama-cpp.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
logbook.md docs(logbook): complete setup and privacy guide 2026-07-05 15:09:43 -04:00
manage-plugins.md feat: add Control UI plugin management (#103176) 2026-07-10 11:56:44 +01:00
manifest.md feat(agents): derive a provider-declared default utility model when unset (#103769) 2026-07-10 17:40:11 +01:00
memory-lancedb.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
memory-wiki.md feat(memory-wiki): isolate vaults per agent (#103349) 2026-07-10 05:19:13 +01:00
message-presentation.md feat(slack): support native chart presentations (#102635) 2026-07-10 04:05:23 +01:00
oc-path.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
plugin-inventory.md feat(qwen): add Token Plan (Team Edition) provider (#94419) 2026-07-09 22:07:01 +01:00
plugin-permission-requests.md fix(workshop): keep approval target names UTF-16 safe (#102963) 2026-07-09 18:26:08 +01:00
reference.md fix(providers): publish Meta provider (#103070) 2026-07-09 12:11:56 -07:00
sdk-agent-harness.md fix(macos): harden fresh AI onboarding (#102637) 2026-07-10 04:59:15 +01:00
sdk-channel-inbound.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
sdk-channel-ingress.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
sdk-channel-message.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
sdk-channel-outbound.md feat(slack): support Enterprise Grid org installs (#102372) 2026-07-08 23:53:19 -07:00
sdk-channel-plugins.md feat(slack): support Enterprise Grid org installs (#102372) 2026-07-08 23:53:19 -07:00
sdk-channel-turn.md refactor: remove channel turn runtime aliases 2026-05-27 11:37:23 +01:00
sdk-entrypoints.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
sdk-migration.md fix(talk): await realtime tool result delivery (#103268) 2026-07-09 20:11:20 -07:00
sdk-overview.md fix(cron): emit scheduled events after durable wake changes (#103647) 2026-07-10 17:39:23 +01:00
sdk-provider-plugins.md feat(xai): support Grok Imagine Video 1.5 (#103316) 2026-07-10 04:49:42 +01:00
sdk-runtime.md fix(voice-call): preserve per-call agent routing (#77763) 2026-07-08 07:06:35 +01:00
sdk-setup.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
sdk-subpaths.md feat(plugin-sdk): export dashboard bootstrap helpers 2026-07-10 07:53:37 +05:30
sdk-testing.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
tool-plugins.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
vault.md Add Vault SecretRef plugin (#89255) 2026-07-09 05:30:12 -05:00
voice-call.md feat(providers): add Qwen 3.6 Flash and Gemini 3.1 Live (#102791) 2026-07-09 13:37:16 +01:00
webhooks.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
workboard.md feat: add Control UI plugin management (#103176) 2026-07-10 11:56:44 +01:00
zalouser.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00