An intelligent, intent-based model router that automatically detects your prompt's context and routes it to the optimal AI agent.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install smart-router-ai
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 smart-router-ai 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 Smart Model Router?
The Smart Model Router is an advanced, automated utility designed to eliminate the friction of manually selecting AI models during development workflows. Built to integrate seamlessly with Openclaw Skills, this router analyzes natural language prompts to determine if you are trying to fix a bug, plan system architecture, or engage in creative conversational flow. By auto-detecting intent through keyword and pattern matching, it ensures your queries are routed to the most capable local or cloud-based model instantly.
Using this capability allows developers to maintain a single interface while benefitting from specialized LLMs. Rather than manually switching agents, you simply type your command. This skill increases task efficiency, drastically reduces cognitive offload, and helps teams maximize the utility of their Openclaw Skills infrastructure.
Smart Model Router Use Cases
- Automatically directing runtime errors, crashes, and debugging prompts directly to specialized coding models like cloud-code.
- Routing system design queries, database schemas, and architectural plans to deep-reasoning models like deepseek-r1.
- Engaging in general conversation, brainstorming sessions, or writing creative content using default conversational models without manual configuration.
- Standardizing AI routing across team environments using predefined keywords and intent matching to optimize model utilization.
How Smart Model Router Works
- The user inputs a prompt or command via the terminal using the Smart Model Router CLI aliases.
- The router analyzes the natural language prompt using a built-in intent detection engine that scans for specific keywords, phrases, and pattern rules.
- The engine calculates a confidence score to classify the intent into one of three primary categories: fix, plan, or flow.
- Based on the classified intent, the router automatically targets and forwards the payload to the optimal configured agent (e.g., cloud-code for bugs, deepseek-r1 for architecture, or kimi-k2.5:cloud for general queries).
- The response streams back to the console, while the query metadata is logged to the router dashboard for analytics.
Smart Model Router Setup
Ensure you have a working OpenClaw agent system on Linux or Termux (Android) with at least two configured agents. Follow these commands to set up this Openclaw Skills add-on:
# Run the automated setup script
bash scripts/setup.sh
# Append the router aliases to your shell configuration
echo 'source ~/.openclaw/workspace/intent-router-aliases.sh' >> ~/.zshrc
source ~/.zshrc
# Verify your intent detection setup
router-test "my app keeps crashing with null pointer"
Smart Model Router Data Schema & Taxonomy
The Smart Model Router organizes its configuration, aliases, and logging history in the following schema:
| File / Resource | Location / Command | Description |
|---|---|---|
| Router Aliases | ~/.openclaw/workspace/intent-router-aliases.sh |
Bash/Zsh shell aliases (fix, plan, flow, ask) for direct command-line execution |
| Analytics Export | report.json |
Generated JSON report detailing routing distribution, hits, and confidence scores |
| History Logs | router-history |
Internal database tracking recent intent classifications and model destinations |
Intent Rules Table
| Intent | Trigger Words | Default Targeted Agent |
|---|---|---|
| fix | bug, error, crash, broken, exception, fail, debug, issue, problem, stuck | cloud-code (CodeLLaMA) |
| plan | design, architect, structure, how should, approach, strategy, pattern | deepseek-r1 (Architect) |
| flow | Default / Fallback | kimi-k2.5:cloud (main) |
Smart Model Router Advanced Features
- Interactive Router Dashboard: Run
router-dashboardto view detailed real-time routing statistics and model usage analytics. - Manual Intent Overrides: Override the automated router at any time using the
--intentand--modelCLI flags (e.g.,ask --intent fix --model deepseek-r1 \"Debug this race condition\"). - Historical Analytics Tracking: Access and audit recent model selections using the
router-history --last 20command. - Custom Data Exports: Easily export routing reports to JSON format using the
--exportflag for team performance monitoring or auditing within your Openclaw Skills suite.
SKILL.md
Loading
Related Openclaw Skills
Email Management (Gmail, Outlook & Exchange)
A secure, multi-account command-line email client designed for AI agents using Openclaw Skills to safely read, search, and manage Gmail, Outlook, and Exchange inboxes.
MCP Token Auditor
Prevent subagent crashes caused by tool schema bloat by auditing your MCP configuration and generating optimized, role-specific setups.
A-Share Investment Meeting Preparer (Meeting Preparer CN)
An AI-driven research agent that automatically compiles regulatory filings, analyst consensus, and financial metrics to produce professional briefing packages for A-share investor meetings.
WeChat Mini Program to uni-app Converter (Vue3 & TypeScript)
An automated migration skill that translates native WeChat Mini Programs into cross-platform uni-app projects featuring Vue3 and TypeScript.
Local MCP Server
A privacy-first, lightweight Model Context Protocol server for Termux and Linux environments that exposes file access, grep, and bash execution tools to offline Ollama models.
Cinematic Prospecting
An AI-powered sales automation tool that extracts data from business card photos, conducts deep brand research, and drafts visually stunning email outreach.
Featured*
