开源评审会要求把 Hermes、OpenClaw 加回适配列表。核对代码后发现它们不是"从未支持",而是今天被一个无关提交顺带删掉的,而且文档没跟着改——这是先要修的部分。
事实
363550c(2026-08-05 13:45,提交信息为 feat: sort provider by creation time desc)从 agents.lock.json 删除了 39 行,内容是三个 guide-only 条目:
- "cursor": { "command": "cursor", ...
- "openclaw": { "command": "openclaw",
- "guide": "Install from OpenClaw docs, then run: openclaw onboard --install-daemon && openclaw gateway status",
- "hermes": { "command": "hermes",
- "guide": "Install Hermes, then configure models with hermes model or ~/.hermes/config.yaml.",
提交信息只提到 provider 排序,完全没有提及删除 Agent。agents.lock.json 现在只剩 5 个条目:codex、claude-code、opencode、kilo-cli、aider,全部是 config_mode: auto。当前没有任何 guide-only Agent。
文档已经与实现不符
以下位置仍然声称这三个存在:
README.md:111 — "OpenClaw, Hermes, and Cursor are guide only"
README_ZH.md:87 — 同上
docs/ai-agent-kit/zh/04-agent-guides.md:41,45 — OpenClaw / Hermes 各有一节
docs/ai-agent-kit/zh/03-config-tools.md:61
docs/distribution-compliance-policy.md:99
frontend/src/pages/AgentSelectionPage.test.tsx:104 — 注释提到 Cursor、OpenClaw、Hermes
这是开源前对外文档虚报功能,比缺功能更糟:用户按 README 下载后找不到条目。
需要做什么
- 恢复
agents.lock.json 里的三个条目(git show 363550c -- agents.lock.json 有原文,直接反向应用即可)
- 补
frontend/src/components/icons/agents.tsx 的标识。注意 docs/internal/cc-switch-reference-notes.md:81 已结论 OpenClaw 与 Hermes 的图标不可取用(CC Switch 的 OpenClaw 图标是自绘、Hermes 只有 256×256 PNG 且无权利依据),所以这两个必须走 Lucide 通用符号,不要从任何第三方项目转绘
- 决定 Cursor 是否一并恢复(它在 README 里与另两个并列,但会议只点名了 Hermes 和 OpenClaw)
边界确认
会议定义的适配边界是:只负责安装、更新、Provider 与基础模型配置,未完成则跳转对应页面。但 docs/internal/cc-switch-reference-notes.md:33 记录的现有结论是 OpenClaw 和 Hermes 保持 guide-only,理由是常驻网关形态被 ADR-002/ADR-003 划在范围外,与能否安装无关。
如果这次要让它们从 guide-only 升级为可安装,那是在改 ADR-002 划定的产品边界,按 CLAUDE.md 的规则需要新的 ADR,不能只改 lock 文件。建议先明确:是恢复原状(guide-only),还是升级为可安装(需 ADR)。这两条路的工作量差很多。
开源评审会要求把 Hermes、OpenClaw 加回适配列表。核对代码后发现它们不是"从未支持",而是今天被一个无关提交顺带删掉的,而且文档没跟着改——这是先要修的部分。
事实
363550c(2026-08-05 13:45,提交信息为feat: sort provider by creation time desc)从agents.lock.json删除了 39 行,内容是三个 guide-only 条目:提交信息只提到 provider 排序,完全没有提及删除 Agent。
agents.lock.json现在只剩 5 个条目:codex、claude-code、opencode、kilo-cli、aider,全部是config_mode: auto。当前没有任何 guide-only Agent。文档已经与实现不符
以下位置仍然声称这三个存在:
README.md:111— "OpenClaw, Hermes, and Cursor are guide only"README_ZH.md:87— 同上docs/ai-agent-kit/zh/04-agent-guides.md:41,45— OpenClaw / Hermes 各有一节docs/ai-agent-kit/zh/03-config-tools.md:61docs/distribution-compliance-policy.md:99frontend/src/pages/AgentSelectionPage.test.tsx:104— 注释提到 Cursor、OpenClaw、Hermes这是开源前对外文档虚报功能,比缺功能更糟:用户按 README 下载后找不到条目。
需要做什么
agents.lock.json里的三个条目(git show 363550c -- agents.lock.json有原文,直接反向应用即可)frontend/src/components/icons/agents.tsx的标识。注意docs/internal/cc-switch-reference-notes.md:81已结论 OpenClaw 与 Hermes 的图标不可取用(CC Switch 的 OpenClaw 图标是自绘、Hermes 只有 256×256 PNG 且无权利依据),所以这两个必须走 Lucide 通用符号,不要从任何第三方项目转绘边界确认
会议定义的适配边界是:只负责安装、更新、Provider 与基础模型配置,未完成则跳转对应页面。但
docs/internal/cc-switch-reference-notes.md:33记录的现有结论是 OpenClaw 和 Hermes 保持 guide-only,理由是常驻网关形态被 ADR-002/ADR-003 划在范围外,与能否安装无关。如果这次要让它们从 guide-only 升级为可安装,那是在改 ADR-002 划定的产品边界,按
CLAUDE.md的规则需要新的 ADR,不能只改 lock 文件。建议先明确:是恢复原状(guide-only),还是升级为可安装(需 ADR)。这两条路的工作量差很多。