快速规则
快速规则¶
模型引用和 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