dab1f08376
* feat: give every plugin a compact chat activity icon Separate package-owned activity SVGs from plugin identity artwork. Ship 154 defaults and seven exact tool overrides, preserving Echo and the progress claw. Include authenticated bounded delivery, safe mask rendering, packaging, and authoring guidance. * test: declare Vite types for the activity asset browser test * refactor: keep plugin artwork selection with catalog presentation facts * test: scope activity browser types and simplify fixture copies |
||
|---|---|---|
| .. | ||
| assets | ||
| api.ts | ||
| index.test.ts | ||
| index.ts | ||
| meta.live.test.ts | ||
| models.ts | ||
| onboard.ts | ||
| openclaw.plugin.json | ||
| package.json | ||
| provider-catalog.ts | ||
| README.md | ||
| stream.ts | ||
| thinking.ts | ||
| tsconfig.json | ||
Meta provider
Official OpenClaw provider plugin for the Meta API — an OpenAI-compatible
Responses API endpoint (POST /v1/responses).
- Base URL:
https://api.meta.ai/v1 - Auth:
Authorization: Bearer $MODEL_API_KEY - Models:
muse-spark-1.3,muse-spark-1.3-contributor,muse-spark-1.2,muse-spark-1.2-contributor,muse-spark-1.1(reasoning models)- Context window: 1,048,576 tokens (input + output share the budget)
- Reasoning effort:
minimal | low | medium | high | xhigh(OpenClaw default:high) - Vision: image input in
usermessages - Tool calling + streaming
- Stateless encrypted reasoning replay (
store: false)
Warning
Meta's pricing documentation and Terms of Service distinguish Standard Services from Contributor/Discounted Services:
- Standard Services are the default. Meta says prompts and completions submitted to Standard Services are not used to train Meta models.
- By using Contributor/Discounted Services, you permit Meta to use Content submitted to and generated by those services as described in the Terms. Under the Terms, use of Discounted Services acknowledges that permission. You must not submit sensitive, confidential, or personal information to the Discounted Services.
Meta's Geographic Use Policy governs availability. It limits API access in some jurisdictions and adds end-user deployment restrictions for products built with the Contributor/Discounted model; those additional restrictions do not apply to your own use or products built with Standard Services.
Meta's model catalog lists text, image, video, audio, and PDF input for these models. OpenClaw's model catalog directly represents text and image input only; the other upstream modalities are not model-manifest input values. Meta does not publish an exact maximum-output figure for these catalog rows.
Usage
Install the plugin and restart Gateway:
openclaw plugins install @openclaw/meta-provider
openclaw gateway restart
Set the API key and select the model:
export MODEL_API_KEY=<key>
// ~/.openclaw/openclaw.json
{
agents: {
defaults: {
model: { primary: "meta/muse-spark-1.3" },
},
},
}
Or run onboarding and choose Meta.
Thinking / reasoning
--thinking <level> and /think <level> map to Responses API reasoning.effort.
OpenClaw defaults to high. Meta's
reasoning documentation says that an
omitted effort uses a model-determined level, so high is an OpenClaw policy rather
than Meta's omitted-parameter default. off maps to minimal because Muse Spark does
not accept none.
Docs
See docs/providers/meta.md for setup, onboarding, and smoke tests.
Live test
export MODEL_API_KEY=<key>
pnpm test:live -- extensions/meta/meta.live.test.ts
The live suite exercises enabled Meta cases against POST /v1/responses.