switch-modes

🎛️ AI模型动态调度与成本优化

OpenClaw 生态的模型调度技能,支持四档模式一键切换,帮助用户在成本与性能间灵活平衡,MIT 开源且纯文档架构安全可靠。

收藏
3k
安装
1.3k
版本
v1.0.1
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

Switch Modes 是一款专为 OpenClaw 生态设计的模型调度技能,旨在通过动态切换 AI 模型实现成本与性能的最优平衡。该技能定义了四种预设工作模式:ECO(经济模式,适合摘要和快速问答)、BALANCED(平衡模式,日常通用)、SMART(智能模式,复杂推理)和 MAX(极致模式,关键任务),用户可通过简单的自然语言指令(如"eco mode")或命令行指令(如"/modes status")实现即时切换。

核心用法方面,用户首次使用需通过 /modes setup 完成配置,为每种模式绑定具体的模型 ID(如 Claude 3.5 Haiku、Claude Opus 等)。配置完成后,系统会将映射关系存储在本地 ~/.openclaw/workspace/switch-modes.json 文件中。日常使用时,用户只需说出模式名称即可触发切换,系统会自动更新 OpenClaw 的主配置文件 openclaw.json 中的 model 字段,切换即时生效无需重启。同时支持 /modes status 查询当前模式状态,方便用户随时掌握当前使用的模型配置。

显著优点包括:第一,显著的成本优化能力,用户可根据任务复杂度灵活选择廉价或高性能模型,避免"杀鸡用牛刀"的资源浪费,特别适合高频使用 AI 且对成本敏感的场景;第二,极简的操作体验,自然语言指令降低了技术门槛,无需记忆复杂的模型 ID;第三,完全的本地化处理,所有配置数据均存储在用户本地目录,不存在数据上传或隐私泄露风险;第四,透明的配置机制,JSON 格式的配置文件可随时查看和手动修改,具备极高的可审计性。

潜在局限性在于:该技能仅支持手动切换,无法根据任务内容自动判断并选择最优模型,智能化程度有限;作为 OpenClaw 生态专用技能,依赖特定的配置文件结构和路径,无法跨平台使用;且需要用户预先了解不同模型的特性和定价策略,对 AI 模型生态不熟悉的新手存在一定认知门槛。

适合的目标群体主要包括:频繁使用 AI 且对成本敏感的个人开发者或中小团队;需要处理多样化任务(从简单摘要到复杂编程)的重度 AI 用户;以及希望精细控制模型开销、优化 AI 预算的产品运营人员。

使用风险方面,虽然该技能为纯文档型资产,但涉及对本地配置文件的读写操作。尽管安全报告显示其仅修改必要的 model 字段且具备完善的错误处理(如 JSON 验证、文件存在性检查),用户仍需确保对 ~/.openclaw/ 目录具有适当的读写权限,并建议定期备份配置文件以防止意外损坏。此外,作为 T3 级个人开发者作品,长期维护稳定性需持续关注。

安全解读

核心用法

Switch Modes 是一个用于 OpenClaw 平台的模型切换管理 Skill。用户通过自然语言指令(如 "eco mode")或命令行指令(如 /modes status/modes setup)即可在四个预设档位间无缝切换:

| 档位 | 定位 | 推荐场景 |
|:---|:---|:---|
| **eco** | 最低成本模型 | 摘要、快速问答、简单格式化 |
| **balanced** | 日常主力模型 | 通用办公、常规对话、轻度编程 |
| **smart** | 高性能模型 | 复杂推理、多步骤任务、代码审查 |
| **max** | 极致性能模型 | 关键任务、深度分析、高难度创意工作 |

首次使用需运行 /modes setup 完成配置,系统将引导用户为每个档位绑定具体的模型 ID(默认推荐 Anthropic Claude 系列)。配置持久化存储于 ~/.openclaw/workspace/switch-modes.json,切换时自动改写主配置文件 openclaw.jsonmodel 字段,即时生效无需重启。

显著优点

1. 成本可控:显式区分"省流档"与"性能档", 避免高成本模型处理简单任务造成的浪费
2. 零学习成本:自然语言指令("eco mode")与 CLI 命令双支持,符合直觉

3. 配置即代码:JSON 配置文件透明可迁移,便于团队共享最佳实践

4. 即时生效:热切换机制,会话内无缝升降档

潜在缺点与局限性

  • 依赖外部配置:需手动维护 switch-modes.json,若模型 ID 失效(API 下架、权限变更)会导致切换失败
  • 无自动推荐逻辑:系统不会根据任务复杂度自动建议档位,完全依赖用户判断
  • OpenClaw 生态绑定:仅兼容 OpenClaw 平台,无法迁移至其他 AI 客户端
  • 配置覆盖风险:直接改写 openclaw.json,若程序异常可能损坏用户原有配置

适合人群

  • 高频 AI 用户:日均调用量高、对 API 成本敏感的专业人士
  • 多场景切换者:同一工作流中既有"快速查资料"又有"深度写代码"需求的开发者
  • 团队管理员:希望为团队成员建立标准化模型配置最佳实践的技术负责人

常规风险

1. 配置持久化风险switch-modes.json 若被篡改或损坏,可能导致模型切换至无效 ID,产生报错或静默失败
2. 权限要求:需要文件系统读写权限,建议在受限沙箱环境中运行

3. 模型可用性漂移:绑定的模型可能因供应商策略调整而下架,需定期验证配置有效性

安全评级说明

该 Skill 为纯 Markdown 文档型实现,无可执行代码、无网络请求、无第三方依赖,通过 CLS-Certify 六维检测获得 S+ 评级。唯一注意事项为作者属个人开发者(T3),建议首次使用前审查 GitHub 仓库历史与社区反馈。

switch-modes 内容

手动下载zip · 5.6 kB
REFERENCE.mdtext/markdown
请选择文件