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 并不表示可以使用较大的变体。
设置¶
运行:
允许本地发现,然后在其出现时选择 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:
运行时行为¶
模型推理在 Gateway 所在的 Mac 上运行;提议的工具调用会经过 OpenClaw 的正常执行和批准流程。助手会在模型请求时启动;不会安装 HTTP 服务器、启动代理或独立的模型守护进程。OpenClaw 保留工具执行及其正常批准检查的所有权。
工具调用通过 OpenClaw 现有的工具模型路由为简短内部任务提供支持,例如会话标题和进度解说。引导流程不会将 Apple 选为常规智能体的主模型。
该模型的上下文窗口由指令、工具定义、对话、工具结果和输出共享。提供商默认每回复最多输出 1,024 个令牌。即使尚未积累有用的对话历史,大型工作区或完整的智能体提示也可能超出窗口。请保持设置问题聚焦;在处理复杂请求时,较小的端侧模型可能不如较大的模型可靠。
原生生成支持封闭对象、数组、原始类型、枚举、可空值和受支持的 schema 联合。字符串长度和正则约束在生成后仍由 OpenClaw 强制执行,因为 Apple 没有为它们提供可用的原生指南。结构化响应在发布前会根据调用方的原始 schema 进行检查。不支持的结构化 schema 会显式失败。
故障排查¶
如果 Apple Intelligence 不可用,请在系统设置中启用它,并等待模型下载完成。更改其可用性后重试设置。
如果报告的上下文窗口低于 8,192 个令牌,请选择其他本地或云端模型。OpenClaw 不会虚增模型宣传的限制。
如果更新后原生助手缺失,请在模型设置中对已配置的工具卡片使用重新检查并修复,或重新运行引导流程并选择检测到的 Apple 模型。这会编译与已安装插件匹配的助手,并再次验证工具路由。普通推理从不编译代码或安装依赖项。
有关其他推理选项,请参阅模型提供商。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw