semantic-router

> 🔒 **安全声明**：本技能需要修改 OpenClaw 配置以实现模型路由功能。所有配置变更前会自动备份，支持一键回滚。建议在测试环境验证后再部署到生产环境。

## ⚠️ Security & Permissions Declaration

**This skill performs the following privileged operations — all are intentional and explicitly user-initiated:**

| Operation | Purpose | Scope |
|-----------|---------|-------|
| Read/patch `~/.openclaw/openclaw.json` | Configure model routing pools | Local config only |
| Read/write `~/.openclaw/workspace/.lib/pools.json` | Store model pool configuration | Workspace only |
| Read/write `~/.openclaw/workspace/.lib/tasks.json` | Store task type definitions | Workspace only |
| Run `semantic_check.py` locally | Classify user messages for routing | No network required |
| Patch session model via `sessions.patch` | Switch active model pool | Current session only |
| Restart OpenClaw Gateway (`openclaw gateway restart`) | Apply routing config changes | Local service only |
| Inject `prependContext` into agent turns | Output routing declaration in first line | Read-only context injection |
| Update Cron Job `sessionTarget` to `"isolated"` | Prevent background tasks from polluting user sessions | Affects only background Cron jobs |

**What this skill does NOT do:**
- Does NOT exfiltrate conversation content or model credentials to external servers
- Does NOT access API keys or secrets directly
- Does NOT modify files outside `~/.openclaw/` and the skill's own workspace
- Does NOT run with elevated (sudo/root) privileges
- Does NOT auto-install additional packages

**Requires:** Python 3.8+, OpenClaw Gateway running, configured model providers

# 🔷 Semantic Router v7.9.3 — 生产级会话路由系统 🔷

**ClawHub**: https://clawhub.ai/halfmoon82/semantic-router  
**版本**: 7.6.3 (生产环境)  
**作者**: halfmoon82
**状态**: ✅ ROM 级固化，完全测试通过

## 🎯 这个技能解决什么问题？

### 核心问题（v7.2 新解决）

你是否遇到过：
- **Cron Job 导致会话频繁重置** — 后台定时任务打断用户交互
- **Discord/T...

# Semantic Router

[![Version](https://img.shields.io/badge/version-7.9.5-blue)](https://clawhub.ai/halfmoon82/semantic-router)
[![License](https://img.shields.io/badge/license-MIT--0-green)](https://spdx.org/licenses/MIT-0.html)
[![Status](https://img.shields.io/badge/status-production_ready-brightgreen)](https://clawhub.ai/halfmoon82/semantic-router)

> **Production-grade session routing system for OpenClaw agents.**

Automatically select the optimal AI model based on conversation context. Four-layer recognition (system filtering → keywords → indicators → semantic similarity), four-pool architecture (Highspeed/Intelligence/Humanities/Agentic), five-branch routing with automatic fallback.

## 🎯 What Problem Does This Solve?

- **Cron Jobs resetting user sessions** — Background tasks interrupting active conversations
- **Discord/Telegram sessions suddenly clearing** — Long tasks losing context
- **AGENTS.md injection failures** — Large files exceeding 20KB limit
- **Model switching overridden by global config** — Routing not taking effect

## ⚠️ Security & Permissions Declaration

**This skill performs privileged operations — all are intentional and user-initiated:**

| Operation | Purpose | Scope |
|-----------|---------|-------|
| Read/patch `~/.openclaw/openclaw.json` | Configure model routing pools | Local config only |
| Read/write `~/.openclaw/workspace/.lib/pools.json` | Store model pool configuration | Workspace only |
| Read/write `~/.openclaw/workspace/.lib/tasks.json` | Store task type definitions | Workspace only |
| Run `semantic_check.py` locally | Classify user messages for routing | No network required |
| Patch session model via `sessions.patch` | Switch active model pool | Current session only |
| Restart OpenClaw Gateway | Apply routing config changes | Local service only |
| Update Cron Job `sessionTarget` | Isolate background tasks from user sessions | Cron jobs only |

**What this skill does NOT do:**
- Does NOT exfiltrate data to external ser...