---
read_when:
    - می‌خواهید از Meta با OpenClaw استفاده کنید
    - به متغیر محیطی MODEL_API_KEY یا انتخاب احراز هویت CLI نیاز دارید
summary: راه‌اندازی Meta (احراز هویت + انتخاب مدل muse-spark-1.1)
title: Meta
x-i18n:
    generated_at: "2026-07-27T15:51:51Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: f2ce7616d9abc14a2d15ee53ea7725d3e70059af1a38bb61dbfe5b3969106432
    source_path: providers/meta.md
    workflow: 16
---

**Meta API** از **Responses API** سازگار با OpenAI (`POST /v1/responses`)
برای مدل استدلالی `muse-spark-1.1` استفاده می‌کند. این ارائه‌دهنده به‌صورت یک
Plugin همراه OpenClaw عرضه می‌شود.

| ویژگی             | مقدار                              |
| ----------------- | ---------------------------------- |
| شناسه ارائه‌دهنده | `meta`                             |
| Plugin            | ارائه‌دهنده همراه                  |
| متغیر محیطی احراز هویت | `MODEL_API_KEY`                    |
| پرچم راه‌اندازی اولیه | `--auth-choice meta-api-key`       |
| پرچم مستقیم CLI   | `--meta-api-key <key>`             |
| API               | Responses API (`openai-responses`) |
| نشانی پایه        | `https://api.meta.ai/v1`           |
| مدل پیش‌فرض       | `meta/muse-spark-1.1`              |
| استدلال پیش‌فرض   | `high` (`reasoning.effort`)        |

## شروع به کار

<Steps>
  <Step title="تنظیم کلید API">
    <CodeGroup>

```bash راه‌اندازی اولیه
openclaw onboard --auth-choice meta-api-key
```

```bash پرچم مستقیم
openclaw onboard --non-interactive --accept-risk \
  --auth-choice meta-api-key \
  --meta-api-key "$MODEL_API_KEY"
```

```bash فقط محیط
export MODEL_API_KEY=<key>
```

    </CodeGroup>

  </Step>
  <Step title="بررسی دردسترس‌بودن مدل‌ها">
    ```bash
    openclaw models list --provider meta
    ```

    ورودی ایستای کاتالوگ `muse-spark-1.1` را فهرست می‌کند. اگر `MODEL_API_KEY` حل نشده باشد،
    `openclaw models status --json` اعتبارنامه مفقود را زیر
    `auth.unusableProfiles` گزارش می‌کند.

  </Step>
</Steps>

## راه‌اندازی غیرتعاملی

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

## کاتالوگ داخلی

| مرجع مدل             | نام           | استدلال | پنجره زمینه | حداکثر خروجی |
| --------------------- | -------------- | --------- | -------------- | ---------- |
| `meta/muse-spark-1.1` | Muse Spark 1.1 | بله       | 1,048,576      | 131,072    |

قابلیت‌ها:

- ورودی متن + تصویر
- فراخوانی ابزار و پخش جریانی
- میزان تلاش استدلالی: `minimal`، `low`، `medium`، `high`، `xhigh` (پیش‌فرض: `high`)
- بازپخش استدلال رمزگذاری‌شده بدون حالت (`store: false`، `include: ["reasoning.encrypted_content"]`)

<Warning>
`muse-spark-1.1` مقدار `reasoning.effort: "none"` را نمی‌پذیرد. OpenClaw برای این ارائه‌دهنده
`--thinking off` را به `minimal` نگاشت می‌کند.
</Warning>

## پیکربندی دستی

```json5
{
  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" },
      },
    },
  },
}
```

<Note>
اگر Gateway به‌صورت دیمن (launchd، systemd، Docker) اجرا می‌شود، مطمئن شوید
`MODEL_API_KEY` برای آن فرایند در دسترس است — برای مثال در
`~/.openclaw/.env` یا از طریق `env.shellEnv`. کلیدی که فقط در یک پوسته
تعاملی صادر شده باشد، به یک سرویس مدیریت‌شده کمکی نمی‌کند، مگر اینکه محیط
به‌طور جداگانه وارد شود.
</Note>

## آزمون دود

```bash
export MODEL_API_KEY=<key>
pnpm test:live -- extensions/meta/meta.live.test.ts
```

آزمون‌های زنده از `muse-spark-1.1` در برابر `POST /v1/responses` استفاده می‌کنند.

## مرتبط

<CardGroup cols={2}>
  <Card title="ارائه‌دهندگان مدل" href="/fa/concepts/model-providers" icon="layers">
    انتخاب ارائه‌دهندگان، مراجع مدل و رفتار جایگزینی هنگام خرابی.
  </Card>
  <Card title="حالت‌های تفکر" href="/fa/tools/thinking" icon="brain">
    سطوح تلاش استدلالی برای muse-spark-1.1.
  </Card>
  <Card title="مرجع پیکربندی" href="/fa/gateway/config-agents#agent-defaults" icon="gear">
    پیش‌فرض‌های عامل و پیکربندی مدل.
  </Card>
</CardGroup>