跳转至

Apple Foundation Models

内置的 Apple Foundation Models 插件通过原生 Foundation Models 框架运行 Apple 的端侧模型。它是一个免费的本地设置与工具模型。设置会将其保存在 utilityModel 中,并保留你的常规智能体模型。当未配置主模型时,它可以为 OpenClaw 设置助手提供支持。在开始常规智能体对话之前,请先选择单独的主模型。

要求

以下要求适用于运行 Gateway 的 Mac。连接到 Linux 或 Windows Gateway 的 Mac 应用不提供此本地推理路由。

  • 配备 Apple 芯片并运行 macOS 27 或更高版本的 Mac。
  • 在系统设置中启用 Apple Intelligence,并已下载其模型。
  • 已安装包含 macOS 27 SDK 的 Apple Swift 开发工具。
  • 存在一个可用系统模型,其上下文令牌至少为 8,192。

该插件会查询实际的模型名称、可用性和上下文窗口。AFM 3 Core Advanced 已在 8,192 令牌窗口下经过测试。具有 4K 窗口的较旧端侧变体不符合此设置选项的资格;拥有 Mac 并不表示可以使用较大的变体。

设置

运行:

openclaw onboard

允许本地发现,然后在其出现时选择 Apple Foundation Models。只有在后台检查确认模型可用且上下文令牌至少为 8,192 后,设置才会提供此选项。在资格未知、缺少先决条件或模型窗口较小时,该选项将保持隐藏。

在首次发现时,OpenClaw 会在临时目录中使用你已安装的 Apple 工具编译内置的 Swift 助手,读取原生模型的可用性和上下文大小,然后删除临时助手。编译和检查在子进程中运行,因此不会阻塞 Gateway 的事件循环。发现过程不会安装推理助手,也不会更改你的配置。该过程有界且可取消;检查失败或超时不会提供该模型。

选择检测到的模型会构建其持久化助手,并在激活前重新检查资格。OpenClaw 不会替你安装开发工具、下载第三方可执行文件或接受许可条款。如果缺少工具,请安装 Xcode 或相应的 Apple 命令行工具后重试。工具必须包含 macOS 27 SDK。

OpenClaw 会在保存前测试所选的工具路由。模型引用为 apple-fm/system;设置会记录检测到的模型名称和上下文限制。不会创建 API 密钥或提供商认证配置文件。即使你的主模型使用不同的智能体运行时,原生路由也使用 OpenClaw 运行时。

在新安装中,引导流程会打开 OpenClaw 设置助手。它可以检查配置并帮助处理渠道和其他设置。界面会保持常规智能体设置不完整,直到你在模型设置中选择并验证主模型,或重新运行 openclaw onboard。之后,Apple 仍作为工具模型;系统助手会正常遵循主模型。

在现有安装中,选择 Apple 会保留你的主模型、回退模型和凭据。如果旧配置依赖隐式主模型,设置会在添加 Apple 提供商之前记录该现有路由。Doctor 和常规配置写入会应用相同的工具模型迁移。如果该迁移仍处于待处理状态,设置会要求你在连接 Apple 之前运行 openclaw doctor --fix 或选择显式主模型。还可以通过 agents.entries.<id>.utilityModel 为每个智能体设置显式的工具模型配置。

后续发现会复用已准备的助手,并再次检查当前模型。要以脚本方式显式选择 Apple:

openclaw onboard --non-interactive --auth-choice apple-fm --accept-risk

运行时行为

模型推理在 Gateway 所在的 Mac 上运行;提议的工具调用会经过 OpenClaw 的正常执行和批准流程。助手会在模型请求时启动;不会安装 HTTP 服务器、启动代理或独立的模型守护进程。OpenClaw 保留工具执行及其正常批准检查的所有权。

工具调用通过 OpenClaw 现有的工具模型路由为简短内部任务提供支持,例如会话标题和进度解说。引导流程不会将 Apple 选为常规智能体的主模型。

该模型的上下文窗口由指令、工具定义、对话、工具结果和输出共享。提供商默认每回复最多输出 1,024 个令牌。即使尚未积累有用的对话历史,大型工作区或完整的智能体提示也可能超出窗口。请保持设置问题聚焦;在处理复杂请求时,较小的端侧模型可能不如较大的模型可靠。

原生生成支持封闭对象、数组、原始类型、枚举、可空值和受支持的 schema 联合。字符串长度和正则约束在生成后仍由 OpenClaw 强制执行,因为 Apple 没有为它们提供可用的原生指南。结构化响应在发布前会根据调用方的原始 schema 进行检查。不支持的结构化 schema 会显式失败。

故障排查

如果 Apple Intelligence 不可用,请在系统设置中启用它,并等待模型下载完成。更改其可用性后重试设置。

如果报告的上下文窗口低于 8,192 个令牌,请选择其他本地或云端模型。OpenClaw 不会虚增模型宣传的限制。

如果更新后原生助手缺失,请在模型设置中对已配置的工具卡片使用重新检查并修复,或重新运行引导流程并选择检测到的 Apple 模型。这会编译与已安装插件匹配的助手,并再次验证工具路由。普通推理从不编译代码或安装依赖项。

有关其他推理选项,请参阅模型提供商。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw