Meta Provider
기준일: 2026-07-26
난이도: 중급
공식 기준: Meta
개요
이 페이지는 OpenClaw Meta provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.
공식 요약: Meta setup (auth + muse-spark-1.1 model selection)
model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.
빠른 참조
| 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.meta.ai/v1 |
| Default model | meta/muse-spark-1.1 |
| Default reasoning | high (reasoning.effort) |
공식 문서 기반 상세
아래는 공식 providers/meta 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.
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.meta.ai/v1 |
| Default model | meta/muse-spark-1.1 |
| Default reasoning | high (reasoning.effort) |
시작하기
Set the API key
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>
Verify models are available
```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 | 131,072 |
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.1does not acceptreasoning.effort: "none". OpenClaw maps--thinking offtominimalfor this provider.
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_KEYis available to that process — for example in~/.openclaw/.envor throughenv.shellEnv. A key exported only in an interactive shell will not help a managed service unless the env is imported separately.
스모크 테스트
export MODEL_API_KEY=<key>
pnpm test:live -- extensions/meta/meta.live.test.ts
Live tests use muse-spark-1.1 against POST /v1/responses.
관련 문서
Choosing providers, model refs, and failover behavior.
Reasoning effort levels for muse-spark-1.1.
Agent defaults and model configuration.
검증 체크리스트
-
openclaw models list --provider meta로 모델이 보이는지 확인 - 기본 model alias를
agents.defaults.model.primary에 설정했는지 확인 - API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
- failover 시 데이터가 다른 provider로 이동할 수 있는지 검토