> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Siêu dữ liệu

**Meta API** sử dụng **Responses API** tương thích với OpenAI (`POST /v1/responses`)
cho mô hình suy luận `muse-spark-1.1`. Nhà cung cấp được phân phối dưới dạng plugin OpenClaw
đi kèm.

| Thuộc tính               | Giá trị                            |
| ------------------------ | ---------------------------------- |
| ID nhà cung cấp          | `meta`                             |
| Plugin                   | nhà cung cấp đi kèm                |
| Biến môi trường xác thực | `MODEL_API_KEY`                    |
| Cờ thiết lập ban đầu     | `--auth-choice meta-api-key`       |
| Cờ CLI trực tiếp         | `--meta-api-key <key>`             |
| API                      | Responses API (`openai-responses`) |
| URL cơ sở                | `https://api.meta.ai/v1`           |
| Mô hình mặc định         | `meta/muse-spark-1.1`              |
| Mức suy luận mặc định    | `high` (`reasoning.effort`)        |

## Bắt đầu

<Steps>
  <Step title="Đặt khóa API">
    <CodeGroup>
      ```bash Thiết lập ban đầu theme={"theme":{"light":"min-light","dark":"min-dark"}}
      openclaw onboard --auth-choice meta-api-key
      ```

      ```bash Cờ trực tiếp theme={"theme":{"light":"min-light","dark":"min-dark"}}
      openclaw onboard --non-interactive --accept-risk \
        --auth-choice meta-api-key \
        --meta-api-key "$MODEL_API_KEY"
      ```

      ```bash Chỉ dùng biến môi trường theme={"theme":{"light":"min-light","dark":"min-dark"}}
      export MODEL_API_KEY=<key>
      ```
    </CodeGroup>
  </Step>

  <Step title="Xác minh các mô hình khả dụng">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider meta
    ```

    Liệt kê mục danh mục tĩnh `muse-spark-1.1`. Nếu không thể phân giải `MODEL_API_KEY`,
    `openclaw models status --json` sẽ báo thông tin xác thực còn thiếu trong
    `auth.unusableProfiles`.
  </Step>
</Steps>

## Thiết lập không tương tác

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice meta-api-key \
  --meta-api-key "$MODEL_API_KEY"
```

## Danh mục tích hợp sẵn

| Tham chiếu mô hình    | Tên            | Suy luận | Cửa sổ ngữ cảnh | Đầu ra tối đa |
| --------------------- | -------------- | -------- | --------------- | ------------- |
| `meta/muse-spark-1.1` | Muse Spark 1.1 | có       | 1,048,576       | 131,072       |

Khả năng:

* Đầu vào văn bản + hình ảnh
* Gọi công cụ và truyền phát
* Mức độ suy luận: `minimal`, `low`, `medium`, `high`, `xhigh` (mặc định: `high`)
* Phát lại suy luận được mã hóa không lưu trạng thái (`store: false`, `include: ["reasoning.encrypted_content"]`)

<Warning>
  `muse-spark-1.1` không chấp nhận `reasoning.effort: "none"`. OpenClaw ánh xạ
  `--thinking off` thành `minimal` cho nhà cung cấp này.
</Warning>

## Cấu hình thủ công

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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>
  Nếu Gateway chạy dưới dạng tiến trình nền (launchd, systemd, Docker), hãy đảm bảo
  `MODEL_API_KEY` khả dụng cho tiến trình đó — ví dụ trong
  `~/.openclaw/.env` hoặc thông qua `env.shellEnv`. Khóa chỉ được xuất trong
  shell tương tác sẽ không có tác dụng với dịch vụ được quản lý, trừ khi môi trường được nhập
  riêng.
</Note>

## Kiểm thử nhanh

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export MODEL_API_KEY=<key>
pnpm test:live -- extensions/meta/meta.live.test.ts
```

Các kiểm thử trực tiếp sử dụng `muse-spark-1.1` với `POST /v1/responses`.

## Liên quan

<CardGroup cols={2}>
  <Card title="Nhà cung cấp mô hình" href="/vi/concepts/model-providers" icon="layers">
    Chọn nhà cung cấp, tham chiếu mô hình và hành vi chuyển đổi dự phòng.
  </Card>

  <Card title="Chế độ suy luận" href="/vi/tools/thinking" icon="brain">
    Các mức độ suy luận cho muse-spark-1.1.
  </Card>

  <Card title="Tham chiếu cấu hình" href="/vi/gateway/config-agents#agent-defaults" icon="gear">
    Giá trị mặc định của tác nhân và cấu hình mô hình.
  </Card>
</CardGroup>