OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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

  • Install the plugin

    bash
    openclaw plugins install @openclaw/meta-provideropenclaw gateway restart

  • Set the API key

    Onboarding
    openclaw onboard --auth-choice meta-api-key
    Direct flag
    openclaw onboard --non-interactive --accept-risk --skip-health \--auth-choice meta-api-key \--meta-api-key "$MODEL_API_KEY"
    Env only
    export MODEL_API_KEY=<key>

  • Verify models are available

    bash
    openclaw models list --provider meta

    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

    bash
    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

    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

    json5
    {  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

    bash
    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.

    Model providers

    Choosing providers, model refs, and failover behavior.
    Thinking modes

    Reasoning effort levels for Muse Spark.
    Configuration reference

    Agent defaults and model configuration.
    Was this useful?
    On this page

    On this page