跳转至

快速规则

快速规则

模型引用和 CLI 辅助命令
  • 模型引用使用 provider/model(示例:opencode/claude-opus-4-6)。
  • agents.defaults.models 存储别名和按模型设置;agents.defaults.modelPolicy.allow 是可选的显式覆盖允许列表。
  • CLI 辅助命令:openclaw onboard、openclaw models list、openclaw models set <provider/model>。
  • models.providers.*.maxTokens 设置提供商级别的输出 Token 默认值。在每个 models.providers.*.models[] 条目中,contextWindow 声明原生窗口,contextTokens 限制活动输入,maxTokens 覆盖该模型的输出容量。当已知时,已配置的输出限制会被钳制到最终的原生上下文窗口:按模型的 contextWindow,否则为发现的窗口。
  • 回退规则、冷却检查和会话覆盖持久化:模型故障转移。
添加提供商身份验证不会更改你的主模型

openclaw configure 在添加或重新身份验证提供商时保留现有的 agents.defaults.model.primary。除非传入 --set-default,否则 openclaw models auth login 同样如此。提供商插件仍可能在其身份验证配置补丁中返回推荐的默认模型,但当已存在主模型时,OpenClaw 会将其视为“使该模型可用”,而不是“替换当前主模型”。

若要有意切换默认模型,请使用 openclaw models set <provider/model> 或 openclaw models auth login --provider <id> --set-default。

OpenAI 提供商/运行时拆分

OpenAI 模型引用和代理运行时是分开的:

  • openai/<model> 选择规范的 OpenAI 提供商和模型。仅前缀永远不会选择 Codex。
  • 当提供商/模型运行时策略未设置或为 auto 时,仅对于精确的官方 HTTPS Platform Responses 或 ChatGPT Responses 路由,且没有自定义提供商请求覆盖,OpenAI 才可能隐式选择 Codex。有效的模型范围 Fast-mode 控制不算作自定义请求参数。
  • 自定义 Completions 适配器、自定义端点以及具有自定义请求行为的路由保留在 OpenClaw 上。明文官方 HTTP 端点会被拒绝。
  • 旧版 Codex 模型引用是旧版配置,doctor 会将其重写为 openai/<model>。
  • 提供商/模型 agentRuntime.id: "openclaw" 会显式地将其他符合条件的路由保留在 OpenClaw 上。agentRuntime.id: "codex" 要求 Codex,并且当有效路由不兼容 Codex 时失败关闭。

参见 OpenAI 隐式代理运行时 和 Codex 测试框架。如果提供商/运行时拆分令人困惑,请先阅读 代理运行时。

插件自动启用遵循相同的边界:隐式兼容 Codex 的有效路由可以启用 Codex 插件,而显式提供商/模型 agentRuntime.id: "codex" 或旧版 codex/<model> 引用需要它。仅 openai/* 前缀本身则不会。

新的 OpenAI API 密钥和 ChatGPT/Codex OAuth 设置会选择规范的 openai/gpt-6-astra 引用。裸直接 API openai/gpt-5.6 别名仍受支持,并解析到 Sol。当添加或刷新 OpenAI 身份验证时,现有的显式主模型(包括 openai/gpt-5.5)会被保留。GPT-5.5 仍可通过任一运行时作为显式恢复选项,供没有 GPT-5.6 访问权限的账户使用。

CLI 运行时

CLI 运行时使用相同的拆分:选择规范的模型引用,例如 anthropic/claude-* 或 google/gemini-*,然后当你想要本地 CLI 后端时,将提供商/模型运行时策略设置为 claude-cli 或 google-gemini-cli。

旧版 claude-cli/* 和 google-gemini-cli/* 引用会迁移回规范提供商引用,并单独记录运行时。旧版 codex-cli/* 引用会迁移到 openai/* 并使用 Codex app-server 路由;OpenClaw 不再保留捆绑的 Codex CLI 后端。

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