核心用法
Switch Modes 是一款面向OpenClaw用户的AI模型动态切换工具，通过预定义的四档模式实现成本与性能的平衡控制。用户可通过自然语言指令（如"eco mode"）或命令行（如"/modes status"）快速切换模型配置，无需手动编辑复杂的JSON配置文件。
使用流程：
1. 首次配置：运行 /modes setup 完成四档模式与具体模型的映射绑定
2. 日常切换：使用 "eco mode"/"balanced mode"/"smart mode"/"max mode" 指令即时切换
3. 状态查询：通过 /modes status 查看当前激活模式及全部配置
四档模式设计：
| 模式 | 定位 | 推荐模型 | 适用场景 |
|------|------|----------|----------|
| ECO | 极简成本 | claude-3.5-haiku | 摘要、快速问答 |
| BALANCED | 日常主力 | claude-sonnet-4-5 | 通用工作流 |
| SMART | 深度推理 | claude-opus-4-5 | 复杂分析任务 |
| MAX | 极限性能 | claude-opus-4-6 / o1-pro | 关键业务场景 |
---
显著优点
1. 架构安全，零代码风险
作为纯文档型Skill，仅包含Markdown指引和JSON元数据，无可执行代码从根本上杜绝了代码注入、命令执行等传统安全威胁。静态分析得分98分，动态分析满分通过。
2. 本地化优先，隐私合规
所有配置存储于用户本地 ~/.openclaw/ 目录，零网络传输、零数据外泄，完全符合GDPR数据最小化原则和CCPA用户知情权要求。
3. 成本精细化管理
针对不同任务复杂度智能匹配模型能力，避免"杀鸡用牛刀"的资源浪费。ECO模式可节省90%以上API成本，MAX模式确保关键任务获得顶级性能。
4. 配置持久化
通过修改 openclaw.json 的primary model实现全局生效，非会话级临时覆盖，切换后所有新会话自动继承新配置。
---
潜在缺点与局限性
1. 网关重启延迟
每次模式切换触发约2秒网关重启，高频切换场景下存在体验中断。不适合需要秒级模型切换的实时交互场景。
2. 单模型架构限制
当前仅支持替换primary model，无法同时激活多个模型实现并行推理或路由分发。复杂多模型工作流需额外工具配合。
3. 配置覆盖风险
直接修改 openclaw.json 可能覆盖其他自定义配置项，建议切换前备份原始文件。Skill本身不提供配置回滚机制。
4. 来源可信度T3级
作者serudda为个人开发者，虽GitHub活跃且有多个开源项目背书，但缺乏企业级安全审计和长期维护承诺。
---
适合人群
- 成本敏感型用户：希望精细控制API支出，按需分配模型资源
- 多场景工作者：日常任务与深度分析需求差异大，需灵活切换
- OpenClaw进阶用户：熟悉配置文件结构，能接受2秒切换延迟
- 隐私优先用户：要求所有配置本地存储，拒绝云端同步
不适合：追求零延迟切换、需要多模型并行、或完全依赖企业级SLA保障的极端场景。
---
常规风险
| 风险类型 | 等级 | 说明 |
|----------|------|------|
| 配置误操作 | 中 | 切换至不适合当前任务的模型可能导致输出质量下降 |
| 配置持久化副作用 | 低 | 全局配置变更影响所有新会话，可能干扰其他工作流 |
| 作者维护中断 | 低 | T3来源存在未来版本弃用或恶意更新风险，建议关注GitHub动态 |
| 本地文件权限 | 低 | 需确保 `~/.openclaw/` 目录权限正确，防止其他用户读取API密钥 |
风险缓解建议：定期备份配置文件、切换前使用 /modes status 确认当前状态、关注社区反馈后再升级新版本。