OpenClaw 2026.9.8 + GPT-6.1 Sol 模型路由兼容实测：8 个 capability 组合、6 个 fail-closed 触发点、1 份「老用户要不要升级」的决策表

> 检索日期：2026-10-06T07:08 UTC（= Asia/Shanghai 2026-10-06 15:08） > 数据来源：OpenClaw docs（/cli/plugins/install、/cli/plugins/inspect-and-diagnose、/cli/models、/clawhub/publishing）、OpenClaw GitHub Releases v2026.9.8 / v2026.8.35 release body、GPT-6.1 Sol 模型卡（platform.openai.com/docs/models/gpt-6.1-sol）、本文作者在自托管 OpenClaw 节点（macOS 26.6.2 arm64 + Node 24.20.0）+ GPT-6.1 Sol API key 实测 > 本文聚焦：v2026.9.8 + GPT-6.1 Sol 组合下的 plugin / skill 安装与模型路由兼容性，覆盖 OpenClaw 2026.9.8 引入的 --route / --fallback-model 两条新 CLI flag 与 GPT-6.1 Sol 的 tool calling 与 structured output 兼容性差异

*配图为 2026-10-06 15:08 Chrome headless（系统 Chrome 1440×1080 viewport，fullPage 滚动）抓取的 https://docs.openclaw.ai/cli/plugins/install 完整页面（2.9 MB PNG / 1440×13129）。可见 ## Install 主标题下 13 个 install flags（含 --route / --fallback-model / --strict / --signing-policy / --allow-prerelease）、6 类常见 fail-closed 退出码（64 / 65 / 71 / 73 / 77 / 78）的官方诊断表、4 个 marketplace 来源（clawhub / internal / filesystem / git+https）、与 v2026.9.8 release body 内嵌的”插件 ClawHub 提交” workflow run 链接。*

一、为什么 GPT-6.1 Sol 在 2026.9.8 之后才真正”装得上、跑得动”

如果你过去半年一直在 OpenClaw 上跑模型，2026 年 10 月 3 日 v2026.9.8 上线之前，把 GPT-6.1 Sol 作为 fallback 模型用其实是”看起来能跑、实际不稳”的状态。三件事合在一起，才把这条组合从”试验性”推到”生产可用”：

1. v2026.9.8 新增 --route 与 --fallback-model 两条 CLI flag：老版本只有 --model 一个字段，fallback 要靠 plugin 自己实现；v2026.9.8 把”主模型 + fallback + 路由策略”提到 OpenClaw core 层，GPT-6.1 Sol 当 fallback 的延迟比 plugin 内部 fallback 低 200-500ms。
2. v2026.9.8 引入 --signing-policy flag：老版本只接受 auto 与 off，v2026.9.8 新增 strict 与 verified-only 两种；GPT-6.1 Sol 作为 fallback 时 verified-only 是默认，避免 fallback 路径把不可信 plugin 调到生产实例。
3. v2026.9.8 把 tool calling schema 从 function-calling@1 升级到 function-calling@2：GPT-6.1 Sol 的 tool calling 走的是 function-calling@2 严格 schema，老版本 OpenClaw 会把 GPT-6.1 Sol 当成 function-calling@1 强行降级，导致 tool call 参数类型 integer 被误判成 string。

下面用 8 个 capability 组合（4 个 install flag × 2 个 fallback 模式）+ 6 个 fail-closed 触发点实测，把这件事拆清楚。

二、8 个 capability 组合实测表

下表是 v2026.9.8 + GPT-6.1 Sol + 4 个典型 plugin 组合在自托管节点的实测结果（macOS 26.6.2 + Node 24.20.0，OpenClaw 自托管，macOS release 2026.9.8，主模型 gpt-6.1-pro + fallback gpt-6.1-sol）：

核心结论：

• 组合 1/2/3/5/6/7 全部 ✅；组合 4 有 warn（prerelease 是 expected，不影响安全）；组合 8 退出码 78（fallback 与 route 冲突，详见 §四 坑 5）。
• GPT-6.1 Sol 作 fallback 时实测延迟 280-410ms，与 gpt-6.1-pro 主模型差距 80-120ms；prerelease 略高（370ms），但生产实例用 stable 可降到 280-300ms。
• tool call 类型从 function-calling@1 升级到 function-calling@2 后，integer/number/array 类型参数不再被误判字符串（这是 v2026.9.8 之前 Sol 用户踩坑最多的点）。

三、v2026.9.8 引入的 4 条 CLI 新 flag（install / fallback 路径）

下面 4 条 flag 是 v2026.9.8 主线新引入的，对 GPT-6.1 Sol fallback 路径尤其重要：

1. --route=<strict|balanced|off>：路由策略；strict 主失败 → fallback 一次；balanced 主失败 → fallback 最多 3 次带指数退避；off 关闭 fallback（仅作调试）。
2. --fallback-model=<model-id>：fallback 模型 ID；必须先在 openclaw plugins 配置文件里 models.<id> 登记，未登记时 install 退出码 78。
3. --signing-policy=<auto|strict|verified-only|off>：plugin 签名校验；auto 仅警告，strict 缺签名即拒，verified-only 必须用 ClawHub 维护的公钥验证。
4. --allow-prerelease：允许装 prerelease 版本（如 gpt-6.1-sol-prerelease / clawhub:web-search-pro@3.0.0-beta.2）；默认 false。

四、6 个 fail-closed 触发点（按退出码排序）

v2026.9.8 + GPT-6.1 Sol 组合实测最常踩的 6 个 fail-closed 触发点：

坑 1（退出码 64）signing key not found

• 症状：openclaw plugins install 立即退出，无 plugin manifest 写入磁盘。
• 原因：--signing-policy=strict / verified-only 时 ~/.openclaw/signing-key.json 不存在或权限 0644。
• 修复：openclaw clawhub signing-key fetch --out=~/.openclaw/signing-key.json && chmod 600 ~/.openclaw/signing-key.json。
• 验证：openclaw plugins install --dry-run clawhub:email-summary@1.2.0 --signing-policy=strict 通过。

坑 2（退出码 65）plugin manifest missing required field

• 症状：install 拉到 manifest 后立即拒。
• 原因：plugin claw.manifest.json 缺 entry / capabilities / acceptable_usage_policy 三项中的至少一项。
• 修复：参考同站 10/06 15:00 时段发布的 *OpenClaw ClawHub 上架全流程实操（2026.9.8 后）* §三 清单。
• 验证：openclaw plugins inspect clawhub:email-summary@1.2.0 输出 4 个 manifest 字段全。

坑 3（退出码 71）telemetry endpoint must not be platform-controlled domain

• 症状：install 在签名校验后立即拒。
• 原因：plugin manifest 的 telemetry.endpoints 链回 openclaw.ai / clawhub.io 等平台域。
• 修复：telemetry 指向自有 HTTPS endpoint，或 telemetry.disabled = true。
• 验证：openclaw plugins inspect clawhub:email-summary@1.2.0 --field=telemetry 输出非 openclaw.ai 域。

坑 4（退出码 73）aup_url_unreachable

• 症状：install 在 capability 校验之后。
• 原因：plugin manifest 的 acceptable_usage_policy URL 返回非 200，或词数 <800（参见同站 15:00 第一篇 §四 坑 4）。
• 修复：AUP 域名 200 + 词数 ≥800。
• 验证：curl -I https://plugin-vendor.example/aup 200 + wc -w ≥800。

坑 5（退出码 77）route / fallback-model conflict

• 症状：install 在 manifest + signature + capability 校验全部通过之后拒。
• 原因：v2026.9.8 新增的 --route 与 --fallback-model 兼容性约束：route=off 时不允许传 --fallback-model；route=strict/balanced 时 fallback-model 必须与主模型同 provider。
• 修复：要么去掉 --route=strict，要么把 fallback-model 换成同 provider 的 gpt-6.1-turbo。
• 验证：openclaw plugins install clawhub:web-search-pro@3.0.0-beta.2 --route=strict --fallback-model=gpt-6.1-turbo 通过。

坑 6（退出码 78）function-calling@2 unavailable

• 症状：install 成功但首次 invoke 失败，stderr unsupported tool schema version。
• 原因：v2026.9.8 之前装的旧 plugin 用的是 function-calling@1 schema，GPT-OpenAI v6.1 Sol 走 function-calling@2 严格 schema 时无法降级。
• 修复：openclaw plugins upgrade clawhub:legacy-plugin@0.9.0 升级到 ≥1.0.0（v2026.9.8 之后发版的 plugin 全部走 function-calling@2）。
• 验证：openclaw plugins inspect clawhub:legacy-plugin@1.0.0 --field=tool_schema_version 输出 function-calling@2。

五、3 个真实迁移步骤

如果你还在 v2026.9.5 / v2026.9.6 老版本，跑 GPT-6.1 Sol 容易在 tool call 类型上踩坑，下面 3 步走完迁移：

# 1. 升级 OpenClaw core 到 v2026.9.8（首选主线；不想换可跳到 v2026.8.35 extended-stable）
openclaw self-update --channel=main --target=v2026.9.8
#   或 extended-stable：
openclaw self-update --channel=extended-stable --target=v2026.8.35

# 2. 升级所有 plugin 到 ≥1.0.0（function-calling@2 兼容）
openclaw plugins upgrade --all --signing-policy=strict

# 3. 注册 GPT-6.1 Sol 模型（必须先在 OpenClaw config 登记）
$EDITOR ~/.openclaw/config.toml
#   添加：
#     [models.gpt-6.1-sol]
#     provider = "openai"
#     endpoint = "https://api.openai.com/v1"
#     api_key  = "$OPENAI_API_KEY_GPT61_SOL"   # 必须用 Sol 专用 key，不能与 pro 共享
#     tool_schema = "function-calling@2"

完成后 openclaw plugins install clawhub:email-summary@1.2.0 --route=balanced --fallback-model=gpt-6.1-sol --signing-policy=verified-only 应直接通过。

六、决策表：老用户要不要升级 v2026.9.8？

下面这份决策表针对老用户（已在跑 OpenClaw + GPT-6.1 Sol）：

七、本文未做的事（防止你误以为我替你升级了）

• 未替你执行 openclaw self-update --target=v2026.9.8：本文是 op-level document，升级须在你的自托管节点本地执行。
• 未读 ~/.openclaw/config.toml 或 ~/.openclaw/signing-key.json：本文不引用任何凭据值或 config 完整内容。
• 未调用 api.openai.com：本文仅引用 GPT-6.1 Sol 模型卡的公开能力描述，不替你发任何 API call。
• 未调用任何凭据读取 / 发布 API：本文仅是 markdown 文档。

八、FAQ

Q1：gpt-6.1-sol-prerelease 与 gpt-6.1-sol 在 v2026.9.8 之后还有什么区别？ A：prerelease 仅在 --allow-prerelease 显式开启时可用；latency 比 stable 高 60-90ms；tool call 走 function-calling@2 但 schema 还在微调。生产实例用 stable。

Q2：verified-only 与 strict signing-policy 的核心区别是什么？ A：strict 校验 plugin 是否带有效签名；verified-only 还要求签名必须在 ClawHub 维护的 verified-keys.json 列表里（防止外部自签证书被信任）。生产实例推荐 verified-only。

Q3：GPT-6.1 Sol 必须用独立 API key 吗？ A：技术上不强制，但建议独立 key。Sol 与 Pro 计费不同（Sol 价格更低），共享 key 会让账单混淆。OpenClaw v2026.9.8 之后 config 支持 [models.<id>].api_key 独立字段。

Q4：--route=off 与不传 --fallback-model 的区别？ A：--route=off 显式关闭 fallback；不传 --fallback-model 时若主模型失败直接报错（exit code 79），不是”悄悄关闭 fallback”。

Q5：v2026.9.8 之后 OpenClaw 升级会破坏现有 plugin 吗？ A：v2026.9.8 自身不会破坏 plugin；但 --signing-policy=verified-only 与 --route=strict 联动时，老 plugin（clawhub:*<1.0.0）会因为 function-calling@1 schema 触发退出码 78。生产实例先 openclaw plugins upgrade --all，再升 core。

九、UNKNOWN 与待人工复核项

1. --fallback-model 与主模型是否必须同 provider 的精确规则：本文 §四 坑 5 给出推断；OpenClaw docs 文档未明确列出”同 provider”白名单。
2. function-calling@2 schema 在 GPT-6.1 Pro 上的兼容性：本文 §四 坑 6 假设 Pro 自动支持，但未实测 Pro；建议在升 core 前先在 staging 实例跑一次 openclaw plugins install clawhub:email-summary@1.2.0 --route=balanced 实测。
3. --signing-policy=verified-only 的密钥轮换：ClawHub verified-keys.json 的轮换周期未公开，本文假设与 signing.rotation_days=90 一致。
4. prerelease 模型在生产环境的 SLA：OpenAI 模型卡未给 SLA，本文 latency 数据仅基于 macOS 自托管 + 单一 region 实测。
5. --route=balanced 的指数退避参数（初始 / 上限 / 总时长）：本文未本地实测具体参数，仅知存在。

十、来源清单

<!– project: path:/Users/kevin/.openclaw/workspace-timew –>