openclaw/docs/plugins/reference
Peter Steinberger 035227797a
feat(onboarding): add Apple on-device setup and utility model (#150376)
* feat(apple-fm): offer on-device inference during Mac setup

Add a macOS-only setup option backed by the native Foundation Models API.
Measure availability and context size, compile the helper during explicit
setup, and keep tool execution and validation with OpenClaw.

Cover native tool handoff, transcript continuation, constrained generation,
platform selection, setup isolation, cancellation, and packaged asset roots.

Refs #109228

* fix(apple-fm): gate setup on background context detection

Offer Apple Foundation Models only after a cancellable background probe confirms an available model with at least 8192 context tokens. Cold discovery compiles a disposable helper with installed Apple tools without installing inference or changing configuration; selection prepares the persistent helper and rechecks eligibility.

Add detected-only auth-choice visibility for classic and app-guided setup. Keep unknown, unavailable, undersized, and stale configured routes out of offered choices while preserving explicit CLI selection and existing configuration.

Validated 122 focused and native live tests, near-limit recall and over-limit rejection, built-plugin discovery, synthetic Control UI visibility and activation, runtime build, core/extension typechecks, targeted core lint, plugin lint, remaining changed-check guards, and independent P0-P2 review. Broad core lint also reports the unchanged pre-existing chat-pane-render.ts line-count violation.

* fix(onboarding): keep utility inference separate from primary models

Use the configured utility model for setup until a primary is selected, and
keep Apple Foundation Models as an optional Mac setup and utility provider.
Carry the model role through discovery, auth, activation, verification, and
recovery across CLI, Control UI, and native Mac clients. Preserve existing
primaries and exclude utility-only choices from implicit primary routing.

Retain native tool constraints and validate structured results before
publication. Keep helper repair available after updates and provide explicit
setup-state facts to the small native model.

Validation covers native Apple inference and tool replay, isolated onboarding,
provider and agent ownership, aliases, recovery, generated protocols, build,
TypeScript, lint, import cycles, and independent review. Native Mac UI tests
remain pending the separate Xcode agreement; compile-only validation passed.

* test(onboarding): drop retired activation diagnostics

* fix(onboarding): preserve setup contracts across entry points

* fix(onboarding): preserve legacy primary routes during utility setup

Preserve shipped implicit primary selection through the canonical config writer
and Doctor before recording utility-model separation. Fresh utility setup stays
without a primary. Pending or deferred legacy conversion is repaired before
provider authentication, without relaxing credential or route-change guards.

Retain dynamic catalog behavior, aliases and profiles, literal model suffixes,
agent ownership, and deliberate provider/model removals. Move unchanged setup
copy behind its existing lazy UI boundary and satisfy native formatting gates.

Validation covers canonical writer and migration regressions, setup activation,
provider effects, routing/readiness, type checks, lint, import boundaries, and
signed native Mac onboarding/recovery tests. Independent review through P2 is
clean; synthetic before/after screenshots render in the PR and originating chat.

* test(onboarding): align utility migration fixtures and wrapper closure
2026-09-16 20:53:06 -07:00
..
a2a.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
acpx.md fix(plugins): canonicalize catalog metadata and ranking (#143730) 2026-09-10 00:48:14 -07:00
active-memory.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
admin-http-rpc.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
alibaba.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
amazon-bedrock-mantle.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
amazon-bedrock.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
anthropic-vertex.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
anthropic.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
apple-fm.md feat(onboarding): add Apple on-device setup and utility model (#150376) 2026-09-16 20:53:06 -07:00
arcee.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
azure-speech.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
baseten.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
beam.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
bonjour.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
brave.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
browser.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
buzz.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
byteplus.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
canvas.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
cerebras.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
chutes.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
clawrouter.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
clickclack.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
cloudflare-ai-gateway.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
codex.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
cohere.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
comfy.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
copilot-proxy.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
copilot.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
crabbox.md feat(crabbox): add a lease-backed sandbox backend for tool-call isolation (#144454) 2026-09-11 15:16:30 -07:00
cua-computer.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
deepgram.md feat(deepgram): support Flux voice-note transcription (#141836) 2026-09-10 09:45:11 +05:30
deepinfra.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
deepseek.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
device-pair.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
diagnostics-otel.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
diagnostics-prometheus.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
diffs-language-pack.md docs: close the remaining ia and ste findings (#144089) 2026-09-10 22:28:26 +08:00
diffs.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
discord.md fix(plugins): canonicalize catalog metadata and ranking (#143730) 2026-09-10 00:48:14 -07:00
document-extract.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
duckduckgo.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
elevenlabs.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
exa.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
fal.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
featherless.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
feishu.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
file-transfer.md docs: close the small audit categories (generated, governance, link, split) (#144029) 2026-09-10 21:52:03 +08:00
firecrawl.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
fireworks.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
fish-audio-speech.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
geolocation.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
github-copilot.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
gmi.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
google-meet.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
google.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
googlechat.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
gradium.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
groq.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
huggingface.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
imap.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
imessage.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
inworld.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
irc.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
kilocode.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
kimi.md fix(kimi): stop treating quota exhaustion as authentication failure (#142656) 2026-09-09 08:16:50 +05:30
line.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
linux-node.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
litellm.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
llama-cpp.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
llm-task.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
lmstudio.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
lobster.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
logbook.md fix(plugins): keep unpublished packages bundled until release (#150316) 2026-09-16 14:46:16 -07:00
longcat.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
matrix.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
mattermost.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
memory-core.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
memory-lancedb.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
memory-wiki.md fix(plugins): keep unpublished packages bundled until release (#150316) 2026-09-16 14:46:16 -07:00
meta.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
microsoft-foundry.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
microsoft.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
migrate-claude.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
migrate-hermes.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
minimax.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
mistral.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
moonshot.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
msteams.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
mxc.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
nextcloud-talk.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
nostr.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
novita.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
nvidia.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
oc-path.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
ollama.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
onepassword.md fix(plugins): keep unpublished packages bundled until release (#150316) 2026-09-16 14:46:16 -07:00
openai.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
opencode-go.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
opencode.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
openrouter.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
openshell.md fix(plugins): canonicalize catalog metadata and ranking (#143730) 2026-09-10 00:48:14 -07:00
perplexity.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
pixverse.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
policy.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
qa-channel.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
qa-lab.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
qianfan.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
qqbot.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
qwen.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
radius.md feat(radius): connect models with browser sign-in and native streaming (#145377) 2026-09-11 19:29:25 -07:00
raft.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
reef.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
runway.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
searxng.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
senseaudio.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
session-share.md feat: share selected sessions read-only with a paired team Gateway (#136253) 2026-09-12 13:35:17 -07:00
sglang.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
signal.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
slack.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
sms.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
stepfun.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
synology-chat.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
synthetic.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
talk-voice.md feat: switch voices during Talk and Discord calls (#146676) 2026-09-15 21:01:36 -07:00
tavily.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
team-reports.md feat: add Team Reports plugin for GitHub and Discord activity reports (#139850) 2026-09-06 23:15:10 -07:00
teams-meetings.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
telegram.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
tencent.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
tlon.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
together.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
tokenjuice.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
tts-local-cli.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
twitch.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
vault.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
venice.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
vercel-ai-gateway.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
visitor-access.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
vllm.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
voice-call.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
volcengine.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
voyage.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
vydra.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
web-readability.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
webhooks.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
whatsapp.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
workboard.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
xai.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
xiaomi.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
zai.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00
zalo.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
zalouser.md fix(plugins): restore search icons and separate official results (#148518) 2026-09-14 14:40:42 -07:00
zoom-meetings.md docs(plugins): mark generated reference pages and fix their shared template (#140254) 2026-09-07 03:14:31 +08:00