switch-modes
Switch between AI models dynamically to optimize costs and performance. Use when the user says mode commands like "eco mode", "balanced mode", "smart mode", or "max mode", or when they want to check their current mode with "/modes status" or configure modes with "/modes setup".
- License 许可
- MIT
- 最近更新
- 2026-05-17
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- switch-modes
- license
- MIT
- metadata
- { "author": "serudda", "version": "1.0.0" }
- description
- Switch between AI models dynamically to optimize costs and performance. Use when the user says mode commands like "eco mode", "balanced mode", "smart mode", or "max mode", or when they want to check their current mode with "/modes status" or configure modes with "/modes setup".
02 资源文件 2
- 参考文档_meta.json277 B
- 参考文档REFERENCE.md7.7 KB
03 SKILL.md 正文
Switch Modes
Dynamically switch between AI models to optimize costs and performance.
When to Use This Skill
Activate this skill when the user mentions:
- Mode switching commands:
eco mode,balanced mode,smart mode,max mode - Status check:
/modes status - Configuration:
/modes setup
How It Works
The skill manages 4 predefined modes, each mapped to a specific model:
- eco → Cheapest model (for summaries, quick questions)
- balanced → Daily driver model (for general work)
- smart → Powerful model (for complex reasoning)
- max → Most powerful model (for critical tasks)
Configuration is stored in ~/.openclaw/workspace/switch-modes.json.
Step-by-Step Instructions
1. Detect Mode Commands
When the user message contains any of these patterns:
eco modeoreco(standalone)balanced modeorbalancedsmart modeorsmartmax modeormax/modes status/modes setup
2. Handle Setup Command (/modes setup)
If the configuration file doesn't exist or user requests setup:
-
Use
AskUserQuestionto gather model preferences for each mode:- ECO mode: Recommend
anthropic/claude-3.5-haiku - BALANCED mode: Recommend
anthropic/claude-sonnet-4-5 - SMART mode: Recommend
anthropic/claude-opus-4-5 - MAX mode: Recommend
anthropic/claude-opus-4-6oropenai/o1-pro
- ECO mode: Recommend
-
Create/update
~/.openclaw/workspace/switch-modes.jsonwith the structure:
{
"eco": "model-id",
"balanced": "model-id",
"smart": "model-id",
"max": "model-id"
}
- Confirm setup completion to the user.
3. Handle Status Command (/modes status)
- Read the OpenClaw config at
~/.openclaw/openclaw.jsonto get current model - Read
~/.openclaw/workspace/switch-modes.jsonto get mode mappings - Determine which mode is currently active by matching the current model
- Display:
✅ Currently in [MODE] mode using [MODEL_ID]
4. Handle Mode Switch Commands
When user requests a mode switch:
-
Read configuration:
cat ~/.openclaw/workspace/switch-modes.jsonIf file doesn't exist, prompt user to run
/modes setupfirst. -
Get the target model from the config based on requested mode (eco/balanced/smart/max)
-
Update OpenClaw config:
- Read current config:
~/.openclaw/openclaw.json - Update the
modelfield with the new model ID - Write back to
~/.openclaw/openclaw.json
- Read current config:
-
Confirm to user:
✅ [MODE] mode activated Now using: [MODEL_ID]
Examples
Example 1: Mode Switch
User: eco mode
Agent: [reads switch-modes.json, gets model for "eco"]
Agent: [updates openclaw.json with new model]
Agent: ✅ ECO mode activated
Now using: anthropic/claude-3.5-haiku
Example 2: Status Check
User: /modes status
Agent: [reads openclaw.json for current model]
Agent: [reads switch-modes.json for mode mappings]
Agent: ✅ Currently in BALANCED mode using anthropic/claude-sonnet-4-5
Example 3: First Time Setup
User: /modes setup
Agent: [uses AskUserQuestion for each mode]
Agent: [creates ~/.openclaw/workspace/switch-modes.json]
Agent: ✅ Setup complete! You can now use:
- eco mode
- balanced mode
- smart mode
- max mode
File Locations
- Configuration:
~/.openclaw/workspace/switch-modes.json - OpenClaw Config:
~/.openclaw/openclaw.json - Example Config: See
example-config.jsonin skill directory
Common Edge Cases
- Config file missing: Prompt user to run
/modes setup - Invalid model ID: Show error and ask user to reconfigure that mode
- Model not available: Suggest checking API keys and model access in OpenClaw
- Ambiguous input: If just "eco" or "smart" without "mode", still treat as mode switch command
- Case insensitive: Accept "ECO MODE", "Eco Mode", "eco mode" all the same
Important Notes
- Mode switching is instant - no restart required
- Changes only affect the current session's default model
- Preserve all other settings in
openclaw.jsonwhen updating model - Always validate JSON before writing config files
- Use absolute paths:
~/.openclaw/...not relative paths
Reference
For detailed troubleshooting, supported models list, and FAQ, see ./REFERENCE.md.
04 同仓库更多 Skills
zvukogram
Text-to-Speech via Zvukogram API with SSML support. Use when you need to generate speech from text, create podcasts, voice notifications, or work with audio. Supports speed control, stress marks, English word transcription, and audio fragment merging.
zohomail
Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels. Use this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-recruit
Zoho Recruit API integration with managed OAuth. Manage candidates, job openings, interviews, and recruitment workflows. Use this skill when users want to read, create, update, or search recruitment data like candidates, job openings, interviews, and applications in Zoho Recruit. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-people
Zoho People API integration with managed OAuth. Manage employees, departments, designations, attendance, and leave. Use this skill when users want to read, create, update, or query HR data like employees, departments, designations, and forms in Zoho People. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-mail
Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels. Use this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-inventory
Zoho Inventory API integration with managed OAuth. Manage items, sales orders, invoices, purchase orders, bills, contacts, and shipments. Use this skill when users want to read, create, update, or delete inventory items, sales orders, invoices, purchase orders, bills, or other inventory records in Zoho Inventory. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.