智能路由器技能

概述

智能路由器是一个先进的模型调度系统，它超越了简单的关键词匹配，使用多维度分析来为每个消息选择最合适的模型。系统包含成本优化、自动模型扫描和性能监控功能。

功能特性

🎯 智能路由

• 多维度分析：消息长度、内容复杂度、模式识别
• 动态模型选择：基于任务类型自动选择最佳模型
• 成本感知：优先使用免费模型，复杂任务才用付费模型
• 上下文感知：考虑对话历史和用户偏好

💰 成本优化

• 预算控制：设置每日/每月预算限制
• 自动降级：简单任务自动使用免费模型
• 使用统计：实时监控各模型成本
• 智能提醒：成本接近阈值时预警

🔄 自动化管理

• 定期扫描：自动发现OpenRouter免费模型
• 性能监控：实时监控路由性能和系统健康
• 自动备份：定期备份配置和日志
• 规则优化：基于使用数据自动优化路由规则

安装和配置

前提条件

• OpenClaw 2026.2.13 或更高版本
• Node.js 18+
• OpenRouter API密钥（用于模型扫描）

快速安装

# 1. 复制技能文件到OpenClaw技能目录
cp -r smart-router-skill /opt/homebrew/lib/node_modules/openclaw/skills/

# 2. 更新OpenClaw配置以启用技能
openclaw config patch --json '{"skills":{"entries":{"smart-router":{"enabled":true}}}}'

# 3. 重启OpenClaw
openclaw gateway restart

详细安装步骤

1. 环境变量设置：

export OPENROUTER_API_KEY="your-openrouter-api-key"
export DEEPSEEK_API_KEY="your-deepseek-api-key"

2. 初始化系统：

cd /Users/nora/.openclaw/users/main/workspace
node enhanced-intent-router.js init

3. 运行集成测试：

./test-integration.sh

4. 部署系统：

node update-openclaw-config.js update
openclaw gateway restart

使用方法

基本路由

// 使用智能路由器路由消息
const { SmartIntentRouter } = require('./enhanced-intent-router.js');

const router = new SmartIntentRouter();
await router.initialize();

const decision = router.analyzeMessage("帮我写一个Python函数");
console.log(decision);
// 输出: { agentId: 'code-agent', model: '4sapi-anthropic/claude-sonnet-4-5-20250929', ... }

命令行工具

# 初始化路由器
node enhanced-intent-router.js init

# 分析消息路由
node enhanced-intent-router.js analyze "你的消息"

# 运行测试用例
node enhanced-intent-router.js test

# 查看性能指标
node enhanced-intent-router.js stats

# 生成详细报告
node enhanced-intent-router.js report

OpenClaw集成

系统自动集成到OpenClaw，无需手动调用。所有消息都会经过智能路由器处理。

配置说明

路由规则配置 (smart-router-config.json)

{
  "routingRules": {
    "priority": [
      {
        "name": "代码相关任务",
        "conditions": {
          "keywords": ["代码", "编程", "Python", "Java"],
          "minLength": 10,
          "maxLength": 5000
        },
        "agent": "code-agent",
        "model": "4sapi-anthropic/claude-sonnet-4-5-20250929",
        "priority": 100
      }
    ],
    "fallback": {
      "agent": "free-agent",
      "model": "openrouter/google/gemma-3-27b-it:free"
    }
  },
  "costOptimization": {
    "budgetLimit": 10.0,
    "dailyLimit": 1.0,
    "preferFreeModels": true
  }
}

自定义路由规则

要添加新的路由规则：

1. 编辑 smart-router-config.json
2. 在 routingRules.priority 数组中添加新规则
3. 设置匹配条件和目标模型
4. 无需重启，系统支持热重载

定时任务

系统包含以下自动化定时任务：

API参考

SmartIntentRouter 类

class SmartIntentRouter {
  // 初始化路由器
  async initialize()
  
  // 分析消息并返回路由决策
  analyzeMessage(message, context)
  
  // 获取性能指标
  getMetrics()
  
  // 生成详细报告
  generateReport()
}

路由决策对象

{
  agentId: 'code-agent',           // 目标代理ID
  model: 'model-id',               // 选择的模型
  reasoning: false,                // 是否启用推理模式
  ruleName: '规则名称',             // 匹配的规则名称
  confidence: 0.95,                // 置信度 (0-1)
  reason: '匹配原因',               // 路由原因
  features: { ... },               // 消息特征分析
  costOptimized: true              // 是否成本优化
}

维护和管理

监控系统健康

# 检查系统状态
node smart-router-maintenance.js health

# 运行每日维护
node smart-router-maintenance.js daily

# 运行每周维护
node smart-router-maintenance.js weekly

备份和恢复

# 创建备份
node smart-router-maintenance.js backup

# 清理旧备份（保留30天）
node smart-router-maintenance.js clean-backups

故障排除

路由器初始化失败

# 检查配置文件
node enhanced-intent-router.js init

# 查看详细错误
OPENCLAW_DEBUG=1 node enhanced-intent-router.js init

路由决策不准确

1. 检查路由规则配置
2. 查看路由日志分析模式
3. 调整规则优先级和条件

OpenRouter扫描失败

# 检查API密钥
echo $OPENROUTER_API_KEY

# 手动运行扫描器
node openrouter-scanner.js

性能优化

缓存设置

系统使用智能缓存减少重复计算。默认缓存TTL为3600秒，可根据使用情况调整：

{
  "performanceSettings": {
    "cacheEnabled": true,
    "cacheTTL": 3600,
    "maxResponseTime": 30000
  }
}

规则优化建议

1. 将高频规则放在前面
2. 使用更精确的匹配条件
3. 定期分析路由日志优化规则
4. 根据使用数据调整规则优先级

安全注意事项

1. API密钥保护：确保所有API密钥安全存储
2. 配置备份：定期备份路由器配置
3. 访问控制：限制对配置文件的访问
4. 日志管理：定期清理敏感日志信息

扩展开发

添加新功能

1. 在 enhanced-intent-router.js 中添加新功能
2. 更新配置文件
3. 运行测试验证
4. 部署到生产环境

自定义分析器

可以扩展 analyzeMessage 方法添加自定义分析逻辑：

class CustomRouter extends SmartIntentRouter {
  analyzeMessage(message, context) {
    // 自定义分析逻辑
    const features = this.extractCustomFeatures(message);
    
    // 调用父类方法
    return super.analyzeMessage(message, { ...context, customFeatures: features });
  }
}

支持与反馈

如有问题或建议：

1. 查看路由日志分析问题
2. 检查系统指标识别瓶颈
3. 调整配置参数优化性能
4. 联系系统管理员获取支持

版本历史

v1.0.0 (2026-02-15)

• 初始版本发布
• 智能多维度路由
• 成本优化系统
• OpenRouter自动扫描
• 完整的维护工具

技能作者：OpenClaw AI
最后更新：2026-02-15
许可证：MIT
状态：生产就绪 ✅