用途与实际影响
这项功能怎样使用
为什么需要它
认证、会话和定时任务都可能各自选模型。只看一个旧开关会漏掉仍可手选的远程路线,也无法说明某次会话是否产生费用。
举个实际例子
我可以问:“新会话默认用本地模型吗,会不会失败后自动花远程费用?”系统会说明默认路线、自动回退和可手选远程模型;这次只读检查不会删除凭据或调用远程模型。
最后我会得到什么
得到默认模型、自动备用路线、辅助与图像模型,以及仍可手选的远程路线;查不到的会话或定时任务覆盖直接写未知。
正常时
官方模型目录确认默认和自动路线均为本地,才称这些路线不自动调用远程模型。
发现问题时
还能手选远程模型,或有会话和定时任务尚未核对,就不能承诺全局零费用。
入口不可用或证据不足时
模型目录读不到时停止分类,不凭提供商名字猜本地或远程。
从哪里开始
在已接通本机 OpenClaw 管理入口的 AI 对话中说“先只读列出默认模型、可手选远程模型和费用边界”。
需要准备什么
- 想了解默认路线还是某次会话费用
- 是否考虑手选远程模型
从开始到拿到结果
- 1
看默认与自动备用模型
AI 读取普通、备用、辅助和图像路线,按模型目录区分本地、远程或尚不清楚。
- 2
再看可手选的远程路线
只说明哪些提供方可用,不展示认证材料或调用付费模型。
- 3
按本次用途选择
默认本地不代表每次会话都免费;定时任务或旧会话未核对时保留未知,修改路线另按本人选择。
技术实现与依据
这里保留实现、关键条件、精确入口、历史记录和验证结果。
9月7日默认仍本地;9月4日目录/认证快照为自动远程0、可选21、认证来源5。全局零费用未强制,远程调用未验关键规则与设计选择
默认 qwen3.8:27b 的 local=true 是本地分类证据,不是一次自然语言推理或 GPU成功证据。
Qwen 11、DeepSeek 2、Z.AI 8 条远程路线仍可手选;不因默认本地删除。
fallback(后备路线) 空、utility/image unset(未设置)让已列自动远程数为 0,但 session(会话)/cron 仍未核对。
旧 on/off/toggle(开/关/切换)返回 exit 2(退出码 2)且不改变运行态;模型变更走官方 models/config(模型/配置)命令。
本模块用到的名词
- automatic route(自动路线)
- 默认、fallback(后备路线)、utility 与图像模型可能自动使用的路线。
- remote selectable route(远程可选路线)
- 仍能由人明确选择的远程模型;存在不代表被调用。
- global zero cost(全局零费用)
- 需要覆盖所有路线、认证、会话和任务的强保证;当前明确未建立。
专业定义
它回答“现在默认走哪里、还可以走哪里、哪些地方可能花钱”,而不是提供一个假的总开关。
解决什么
防止成本判断被一个过期开关简化,也防止为追求“零费用”偷偷删掉用户仍需要的远程路线。
当前怎样实现
- api.ps1 status 同时读取 openclaw models status --json 与 models list --json。
- 只有 catalog(目录) entry.local=true 或一个 Provider 的全部目录条目 local=true 才分类为 local。
- 输出 cost_posture.v2,并固定 global_zero_cost_enforced=false、mode_switch_available=false、session_and_job_overrides_checked=false。
执行流程
- 1
读取默认、fallback(后备路线)、utility 与 image。
- 2
从官方目录判定每条自动路线 local 或 remote_or_unknown。
- 3
统计 allowed 中仍可手选的远程路线与 Provider。
- 4
脱敏统计远程认证来源。
- 5
说明会话和 cron 未核对,再由用户决定是否通过官方命令变更。
边界
- 不输出认证值、账号标签或私人配置原文。
- 不发送模型请求。
- 不删除认证、不强杀端口、不停计划任务。
失败与恢复
- 官方模型目录为空或 exact model 不存在
- 分类为 remote_or_unknown 或直接失败,不因名字含 ollama 就猜本地。
- 用户调用旧 on/off/toggle
- 解释退役原因,exit 2,不修改状态。
- 需要全局零费用保证
- 必须另行核对会话、cron、全部认证与路由;当前状态页不冒充完成。
真实入口
api.ps1成本姿态 v2 与旧 action 退役
docs/OPENCLAW.md模型、会话、任务和认证的四轴解释
tools/test-api-status.ps1本地目录分类、远程路线与失败合同测试
如何验证
- 默认 ollama5090d/qwen3.8:27b 由官方 catalog(目录) local=true 证明。
- 自动远程 0;远程可选 21=Qwen 11+DeepSeek 2+Z.AI 8,认证来源 5。
- 任何远程付费 Live(真实调用)、本地 27B 自然语言推理与 GPU 实跑均未执行。
与其他模块的关系
模型模块接收渠道或其他客户端交来的任务;更新模块在升级后会重新核对模型目录与默认路线。
