ToolRouter Gateway
Unified access to 150+ tools via ToolRouter API. Dynamically exposes research, security scanning, video production, web extraction, and more as native OpenClaw tools. Caching, usage tracking, and MCP transport included.
ToolRouter Gateway
One skill to rule them all. ToolRouter provides 150+ tools (competitor research, vulnerability scanning, video generation, web scraping, etc.). This skill makes them feel like native OpenClaw tools.
How It Works
- Discovery — Fetches ToolRouter's tool catalog (cached 24h)
- Dynamic Tools — Each ToolRouter tool becomes
toolrouter_<slug>in your registry - Proxy — All calls go to
https://api.toolrouter.com/mcpwith your API key - Caching — Responses cached by input hash (TTL configurable)
- Usage Tracking — Counts calls per tool, shows in status
Prerequisites
- ToolRouter API key (get at https://toolrouter.com — auto-provisioned on first use)
- Set environment variable:
TOOLROUTER_API_KEY=your_key
Tools
toolrouter_discovery
Search the catalog:
{
"query": "competitor",
"category": "research",
"limit": 10
}
Returns list of available tools with:
slug— use in tool name (toolrouter_<slug>)name,descriptioninput_schema— JSONSchema for the toolcategory,pricing(cost per call)
toolrouter_status
{}
Returns:
{
"api_connected": true,
"cache_age_minutes": 12,
"total_calls": 147,
"calls_today": 23,
"enabled_tools": 42,
"errors_last_24h": 0
}
Dynamic Tools (examples)
Once catalog is fetched, you can call any ToolRouter tool:
# Competitor research
tool("toolrouter-gateway", "toolrouter_competitor_research", {
"url": "https://example.com",
"depth": "full"
})
# Vulnerability scan
tool("toolrouter-gateway", "toolrouter_security_scan", {
"target": "https://myapp.com",
"checks": ["cve", "misconfig"]
})
# Video generation
tool("toolrouter-gateway", "toolrouter_video_from_brief", {
"brief": "30s product demo for OpenClaw Memory Stack",
"style": "modern"
})
Tool names are derived from ToolRouter slugs (replace hyphens with underscores, add toolrouter_ prefix). The toolrouter_discovery tool tells you which slugs exist.
Configuration
Optional toolrouter-gateway-config.json:
{
"api_url": "https://api.toolrouter.com/mcp",
"cache_ttl_minutes": 1440,
"usage_log_file": "memory/toolrouter-usage.jsonl",
"enable_caching": true,
"timeout_seconds": 60
}
Caching
- Cache key: SHA256 of tool name + input JSON
- Stored in
memory/toolrouter-cache.jsonl - Reduces cost and improves speed for repeated calls
- Can be cleared manually if needed
Usage Tracking
All calls logged to memory/toolrouter-usage.jsonl:
{"timestamp":"2026-04-01T17:40:00Z","tool":"competitor_research","input_hash":"abc123","cost":0.005}
toolrouter_status aggregates these.
Error Handling
- API down → returns cached response if available, else error
- Rate limits → exponential backoff retry (3 attempts)
- Invalid tool →
discoverytool will reflect removal from catalog
MCP Integration
The gateway can also run as an MCP server (experimental):
# Start MCP server (stdio)
toolrouter-gateway --mcp
Other MCP clients can then connect and use all ToolRouter tools as MCP resources.
Pricing
$49/month. Includes:
- Unlimited tool calls (you pay ToolRouter usage separately; most tools cost fractions of a cent)
- Caching reduces your ToolRouter bill
- Usage analytics
- Priority support
You need your own ToolRouter API key (free tier available).
FAQ
Q: Do I pay per ToolRouter call?
A: Yes, ToolRouter charges per call (typically $0.001–$0.05). Our caching minimizes costs.
Q: Can I add my own tools to ToolRouter?
A: ToolRouter is a separate service; contact them for custom integrations.
Q: What if a tool is flaky?
A: Check toolrouter_status for error rates. Cache helps smooth failures.
Q: Is there a free trial?
A: Not yet. But ToolRouter has a free tier with limited calls.
Inspired by ClawHub's toolrouter skill, extended with caching, usage tracking, and native tool manifests.
Related skills
- Downloads
- 828All time
- Security audit
- Review
- Last updated
- 6mo ago
- Current version
- v1.0.0
- License
- MIT-0
