openclaw/docs/providers/meta.md

summary, title, read_when

summary	title	read_when
Meta setup (auth + muse-spark-1.1 model selection)	Meta	You want to use Meta with OpenClaw You need the MODEL_API_KEY env var or CLI auth choice

The Meta API uses the OpenAI-compatible Responses API (POST /v1/responses) for the muse-spark-1.1 reasoning model. The provider ships as a bundled OpenClaw plugin.

Property	Value
Provider id	meta
Plugin	bundled 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.ai.meta.com/v1
Default model	meta/muse-spark-1.1
Default reasoning	high (reasoning.effort)

Getting started

openclaw onboard --auth-choice meta-api-key

openclaw onboard --non-interactive --accept-risk \
  --auth-choice meta-api-key \
  --meta-api-key "$MODEL_API_KEY"

export MODEL_API_KEY=<key>

</CodeGroup>

```bash openclaw models list --provider meta ```

Lists the static `muse-spark-1.1` catalog entry. 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 \
  --mode local \
  --auth-choice meta-api-key \
  --meta-api-key "$MODEL_API_KEY"

Built-in catalog

Model ref	Name	Reasoning	Context window	Max output
meta/muse-spark-1.1	Muse Spark 1.1	yes	1,048,576	128,000

Capabilities:

• Text + image input
• Tool calling and streaming
• Reasoning effort: minimal, low, medium, high, xhigh (default: high)
• Stateless encrypted reasoning replay (store: false, include: ["reasoning.encrypted_content"])

`muse-spark-1.1` does not accept `reasoning.effort: "none"`. OpenClaw maps `--thinking off` to `minimal` for this provider. Until `muse-spark-1.1` is deployed, smoke tests and manual checks can use the deployed `muse-spark` model id: `--model meta/muse-spark`.

Manual config

{
  env: { MODEL_API_KEY: "<key>" },
  agents: {
    defaults: {
      model: { primary: "meta/muse-spark-1.1" },
      models: {
        "meta/muse-spark-1.1": { alias: "Muse Spark 1.1" },
      },
    },
  },
}

If the Gateway runs as a daemon (launchd, systemd, Docker), make sure `MODEL_API_KEY` is available to that process — for example in `~/.openclaw/.env` or through `env.shellEnv`. A key exported only in an interactive shell will not help a managed service unless the env is imported separately.

Smoke test

export MODEL_API_KEY=<key>
export OPENCLAW_LIVE_TEST=1
export META_LIVE_TEST=1
pnpm test extensions/meta/meta.live.test.ts

Live tests use deployed muse-spark against POST /v1/responses.

Related

Choosing providers, model refs, and failover behavior. Reasoning effort levels for muse-spark-1.1. Agent defaults and model configuration.