Skip to main content
Meta API 使用与 OpenAI 兼容的 Responses API（POST /v1/responses） 来处理 Muse Spark 推理模型。OpenClaw 将 Meta 作为官方外部插件提供。

​
开始使用

1

安装插件

2

设置 API 密钥

3

验证模型是否可用

列出静态的 Muse Spark catalog 条目。如果 MODEL_API_KEY 未解析， openclaw models status --json 会在 auth.unusableProfiles 下报告缺失的凭据。

​
非交互式设置

​
内置目录

价格和数据使用条款来自 Meta 的 定价和速率限制 文档。
Meta 的定价文档和 服务条款区分了标准服务 和 Contributor／Discounted 服务：
  • 标准服务是默认选项。Meta 表示，提交至标准服务的提示词和补全内容不会用于训练 Meta 模型。
  • 通过使用 Contributor／Discounted 服务，你允许 Meta 按照条款中的说明使用提交至这些服务以及由这些服务生成的内容。根据条款，使用 Discounted 服务即表示你认可该许可。你不得向 Discounted 服务提交敏感、机密或个人信息。
Meta 的地理使用政策 规定了可用性。该政策限制了某些司法管辖区的 API 访问，并对使用 Contributor／Discounted 模型构建的产品增加了终端用户部署限制； 这些额外限制不适用于你自行使用标准服务或使用标准服务构建的产品。
功能：
  • 通过 OpenClaw 输入文本和图像
  • 工具调用和流式传输
  • 推理强度：minimal、low、medium、high、xhigh（OpenClaw 默认值：high）
  • 无状态加密推理重放（store: false、include: ["reasoning.encrypted_content"]）
Meta 的模型目录列出了这些模型支持的文本、图像、视频、 音频和 PDF 输入。OpenClaw 的模型目录仅直接表示文本和图像输入；上游支持的其他模态并不是模型清单中的输入 值。 如果未配置思考级别，OpenClaw 会明确选择 high。这是 OpenClaw 的默认行为，而不是 Meta 对省略参数的处理方式：Meta 的 推理文档说明，当省略 reasoning.effort 时，模型会以由模型决定的级别进行推理。
Muse Spark 不接受 reasoning.effort: "none"。对于此提供商，OpenClaw 会将 --thinking off 映射为 minimal。

​
手动配置

如果 Gateway 作为守护进程运行（launchd、systemd、Docker），请确保该进程可以使用 MODEL_API_KEY —— 例如放在 ~/.openclaw/.env 中，或通过 env.shellEnv 提供。仅在交互式 shell 中导出的密钥对受管理的服务没有帮助，除非另外导入了 env。

​
烟雾测试

实时测试套件会针对 POST /v1/responses 执行已启用的 Meta 用例。

​
相关内容

模型提供商

选择提供商、模型引用和故障转移行为。

思考模式

Muse Spark 的推理力度级别。

配置参考

代理默认值和模型配置。