54a986072f
* docs(plugins): remove obsolete Gateway restart guidance * docs(plugins): simplify apply hints and update Session Share guidance
7.1 KiB
| summary | title | read_when | ||
|---|---|---|---|---|
| Meta setup, authentication, and Muse Spark model selection | Meta |
|
The Meta API uses the OpenAI-compatible Responses API (POST /v1/responses)
for the Muse Spark reasoning models. OpenClaw provides Meta as an official external
plugin.
| Property | Value |
|---|---|
| Provider id | meta |
| Plugin | @openclaw/meta-provider |
| Auth env var | MODEL_API_KEY |
| Onboarding flag | --auth-choice meta-api-key |
| Direct CLI flag | --meta-api-key <key> |
| API | Responses API (openai-responses) |
| Base URL | https://api.meta.ai/v1 |
| Default model | meta/muse-spark-1.3 |
| OpenClaw reasoning default | high (reasoning.effort) |
Getting started
```bash openclaw plugins install @openclaw/meta-provider ```Installation applies to a running Gateway automatically; otherwise it takes effect
on the next startup. See [Apply changes and inspect](/plugins/manage-plugins#apply-changes-and-inspect).
openclaw onboard --auth-choice meta-api-key
openclaw onboard --non-interactive --accept-risk --skip-health \
--auth-choice meta-api-key \
--meta-api-key "$MODEL_API_KEY"
export MODEL_API_KEY=<key>
</CodeGroup>
Lists the static Muse Spark catalog entries. If `MODEL_API_KEY` is unresolved,
`openclaw models status --json` reports the missing credential under
`auth.unusableProfiles`.
Non-interactive setup
openclaw onboard --non-interactive --accept-risk --skip-health \
--mode local \
--auth-choice meta-api-key \
--meta-api-key "$MODEL_API_KEY"
--mode defaults to local, so this is the same run as the Direct flag
command above. Run it on the Gateway host: remote-client onboarding
(--mode remote) only configures the local client connection and does not set
up provider credentials on the server.
Built-in catalog
Prices and data-use terms come from Meta's pricing and rate limits documentation. Meta's model catalog identifies Muse Spark 1.3 as the latest version and recommends it for new work.
| Model ref | Name | OpenClaw input | Reasoning | Context window | Input / cached input / output per 1M tokens |
|---|---|---|---|---|---|
meta/muse-spark-1.3 |
Muse Spark 1.3 | text, image | yes | 1,048,576 | $1.25 / $0.15 / $4.25 |
meta/muse-spark-1.3-contributor |
Muse Spark 1.3 Contributor | text, image | yes | 1,048,576 | $0.10 / $0.002 / $0.20 |
meta/muse-spark-1.2 |
Muse Spark 1.2 | text, image | yes | 1,048,576 | $1.25 / $0.15 / $4.25 |
meta/muse-spark-1.2-contributor |
Muse Spark 1.2 Contributor | text, image | yes | 1,048,576 | $0.10 / $0.002 / $0.20 |
meta/muse-spark-1.1 |
Muse Spark 1.1 | text, image | yes | 1,048,576 | $1.25 / $0.15 / $4.25 |
- 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.
Capabilities:
- Text and image input through OpenClaw
- Tool calling and streaming
- Reasoning effort:
minimal,low,medium,high,xhigh(OpenClaw default:high) - Stateless encrypted reasoning replay (
store: false,include: ["reasoning.encrypted_content"])
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.
OpenClaw explicitly selects high when no thinking level is configured. This is an
OpenClaw default, not Meta's omitted-parameter behavior: Meta's
reasoning documentation says that when
reasoning.effort is omitted, the model reasons at a model-determined level.
Manual config
{
env: { vars: { MODEL_API_KEY: "<key>" } },
agents: {
defaults: {
model: { primary: "meta/muse-spark-1.3" },
models: {
"meta/muse-spark-1.3": { alias: "Muse Spark 1.3" },
},
},
},
}
Smoke 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.