A safety-first configuration manager for Openclaw that prevents gateway crashes by validating model assignments and automating backups.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install model-switchboard
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install model-switchboard using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Model Switchboard?
Model Switchboard v3.0 is a robust utility designed to eliminate the risks associated with manual configuration changes in your AI environment. Direct edits to model fields are the leading cause of gateway failures; this skill provides a secure abstraction layer to manage model roles without the risk of corruption. By enforcing strict validation rules and maintaining a rolling history of backups, the skill ensures that your workspace remains stable and functional.
As a core component of the Openclaw Skills ecosystem, it handles everything from primary LLM assignments to complex image processing fallbacks. It bridges the gap between raw configuration and user-friendly management, offering both a powerful CLI and a visual Canvas UI to monitor provider health and model status.
Model Switchboard Use Cases
- Safely switching between Claude, GPT, and Gemini models without manual JSON editing.
- Implementing 3-deep redundancy failover chains for high-reliability agent workflows.
- Previewing configuration changes with dry-run commands to avoid gateway downtime.
- Managing vision-capable models specifically for image processing tasks.
- Recovering instantly from configuration errors using the automated rollback system.
How Model Switchboard Works
- The user or agent issues a command via the switchboard CLI script to change or view model settings.
- The validation engine checks the model format and ensures the provider/model pair matches the required capabilities like vision or tool use.
- An automatic backup of the current configuration is created and stored in a rolling 30-entry history before any modification.
- The skill utilizes the official system CLI to apply changes safely rather than modifying raw JSON files directly.
- The gateway status and provider health are verified post-change to ensure the new configuration is operational.
Model Switchboard Setup
To get started with this addition to your Openclaw Skills library, ensure the script is executable and define the path for easier access.
# Define the switchboard path variable
SWITCHBOARD="$SKILL_DIR/scripts/switchboard.sh"
# View current model setup and health
$SWITCHBOARD status
# Run a diagnostic check on providers
$SWITCHBOARD health
You can also access the visual dashboard by running $SWITCHBOARD ui to generate the necessary data for the Canvas interface.
Model Switchboard Data Schema & Taxonomy
The skill organizes data through a registry and a backup system to ensure configuration integrity across your Openclaw Skills.
| Component | Purpose | File Path |
|---|---|---|
| Model Registry | Database of known model capabilities and providers | model-registry.json |
| Validation Engine | Python script for role and capability compatibility | scripts/validate.py |
| CLI Tool | Main entry point for all configuration actions | scripts/switchboard.sh |
| UI Dashboard | Single-file Canvas interface for visual management | ui/index.html |
Model Switchboard Advanced Features
- Multi-depth redundancy deployment for automated failover management across different providers.
- Integrated Canvas UI for visual status monitoring and model allowlist management.
- Automated cron validation to ensure scheduled tasks always use currently valid and active models.
- Portable configuration support via import and export of model settings for environment replication.
- Real-time diagnostics for gateway status and provider-specific authentication health.
SKILL.md
Loading
Related Openclaw Skills
Clawringhouse AI Shopping Concierge
A proactive AI shopping partner that researches products, compares alternatives, and prepares digital carts to simplify the purchasing process for users.
GouGouBi Configurable Price Prediction Market Skill
A technical skill for deploying and managing Polymarket-style CPMM prediction markets using Uniswap V3 as a price oracle.
BSC Giveaway Contract Call Skill
A comprehensive technical skill for interacting with the BSC on-chain giveaway contract to manage token distributions and claims.
API Credits Lite
A visual API credit monitoring tool that tracks LLM provider balances with gaming-inspired health bars and automated sync capabilities.
Nano Banana 2: Gemini Image Generation & Editing
A sophisticated image generation and editing tool leveraging the gemini-3.1-flash-image-preview model for high-fidelity visual assets.
Openclaw CRM
A local-first, SQLite-powered CRM designed for tracking leads and sales pipelines through a specialized command-line interface.