切换模式

动态切换 AI 模型，以优化成本与性能。

何时使用该技能

当用户提及以下内容时，启用此技能：

• 模式切换指令：eco mode、balanced mode、smart mode、max mode
• 状态查询：/modes status
• 配置初始化：/modes setup

工作原理

该技能管理 4 种预定义模式，每种模式对应一个特定模型：

• eco → 最低成本模型（适用于摘要生成、快速问答）
• balanced → 日常主力模型（适用于通用任务）
• smart → 高性能模型（适用于复杂推理）
• max → 最强性能模型（适用于关键任务）

配置信息存储于 ~/.openclaw/workspace/switch-modes.json。

分步操作指南

1. 识别模式指令

当用户消息中包含以下任一模式时：

• eco mode 或独立出现的 eco
• balanced mode 或独立出现的 balanced
• smart mode 或独立出现的 smart
• max mode 或独立出现的 max
• /modes status
• /modes setup

2. 处理配置指令（/modes setup）

若配置文件不存在，或用户主动请求配置：

1. 调用 AskUserQuestion 收集各模式对应的模型偏好：

   • ECO 模式：推荐 anthropic/claude-3.5-haiku
   • BALANCED 模式：推荐 anthropic/claude-sonnet-4-5
   • SMART 模式：推荐 anthropic/claude-opus-4-5
   • MAX 模式：推荐 anthropic/claude-opus-4-6 或 openai/o1-pro

2. 创建或更新 ~/.openclaw/workspace/switch-modes.json，结构如下：

{
	"eco": "model-id",
	"balanced": "model-id",
	"smart": "model-id",
	"max": "model-id"
}

3. 向用户确认配置已完成。

3. 处理状态查询指令（/modes status）

1. 读取 OpenClaw 主配置文件 ~/.openclaw/openclaw.json，获取当前模型 ID
2. 读取 ~/.openclaw/workspace/switch-modes.json，获取各模式映射关系
3. 通过比对当前模型 ID，确定当前激活的模式
4. 输出提示：✅ 当前处于 [MODE] 模式，正在使用 [MODEL_ID]

4. 处理模式切换指令

当用户请求切换模式时：

1. 读取配置文件：

   cat ~/.openclaw/workspace/switch-modes.json
   

   若文件不存在，提示用户先执行 /modes setup。

2. 根据所请求的模式（eco / balanced / smart / max）从配置中获取目标模型 ID

3. 更新 OpenClaw 配置：

   • 读取当前配置：~/.openclaw/openclaw.json
   • 将 model 字段更新为目标模型 ID
   • 写回至 ~/.openclaw/openclaw.json

4. 向用户确认结果：

   ✅ [MODE] 模式已启用
   现在正在使用：[MODEL_ID]
   

示例

示例 1：模式切换

User: eco mode
Agent: [读取 switch-modes.json，获取 "eco" 对应的模型]
Agent: [更新 openclaw.json 中的 model 字段]
Agent: ✅ ECO 模式已启用
      现在正在使用：anthropic/claude-3.5-haiku

示例 2：状态查询

User: /modes status
Agent: [读取 openclaw.json 获取当前模型]
Agent: [读取 switch-modes.json 获取模式映射]
Agent: ✅ 当前处于 BALANCED 模式，正在使用 anthropic/claude-sonnet-4-5

示例 3：首次配置

User: /modes setup
Agent: [调用 AskUserQuestion 逐项配置各模式]
Agent: [创建 ~/.openclaw/workspace/switch-modes.json]
Agent: ✅ 配置完成！您现在可以使用：
      - eco mode
      - balanced mode
      - smart mode
      - max mode

文件路径

• 模式配置文件：~/.openclaw/workspace/switch-modes.json
• OpenClaw 主配置文件：~/.openclaw/openclaw.json
• 配置示例文件：参见技能目录下的 example-config.json

常见边界情况

1. 配置文件缺失：提示用户运行 /modes setup
2. 模型 ID 无效：返回错误信息，并引导用户重新配置对应模式
3. 模型不可用：建议用户检查 OpenClaw 中的 API 密钥及模型访问权限
4. 输入模糊：若仅输入 "eco" 或 "smart"（不含 "mode"），仍视为模式切换指令
5. 大小写不敏感：支持 "ECO MODE"、"Eco Mode"、"eco mode" 等任意大小写组合

重要说明

• 模式切换即时生效，无需重启应用
• 变更仅影响当前会话的默认模型
• 更新模型时，需保留 openclaw.json 中所有其他配置项不变
• 写入配置文件前，必须校验 JSON 格式有效性
• 始终使用绝对路径：~/.openclaw/...，禁止使用相对路径

参考文档

如需详细排错指南、支持的模型列表及常见问题解答，请参阅 ./REFERENCE.md。