OpenClaw 智能路由器

通过智能、自动的模型选择，节省 30–50% 的模型成本。

它是什么？

首个 OpenClaw 技能，可基于**任务复杂度分析与预算约束**，自动将请求路由至最优模型。避免在简单任务上浪费昂贵模型资源。持续学习您的使用模式，并随时间推移变得越来越智能。

核心功能

• 🎯 节省 30–50% 成本 —— 基于任务复杂度自动选择模型
• 🧠 复杂度分析 —— 对任务进行 0.0–1.0 打分，并据此选择合适模型
• 💰 预算感知能力 —— 尊重支出限额与成本目标
• 📊 模式学习 —— 学习哪些模型对您的任务效果最佳
• 🔄 多服务商支持 —— 兼容 Anthropic、OpenAI、Google 等多家服务商
• 💸 x402 支付支持 —— Agent 可自主支付以启用无限路由（每月 0.5 USDT）

免费版 vs 专业版

免费版：

• 每日最多 100 次路由决策
• 自动复杂度分析
• 基础模型选择
• 成本追踪

专业版（每月 0.5 USDT）：

• 无限次路由决策
• 高级模式学习
• 自定义路由规则
• 详细分析报告与 ROI 追踪
• 预算优化

安装

claw skill install openclaw-smart-router

命令

# 查看路由统计信息
claw router stats

# 分析任务复杂度
claw router analyze "您的任务描述..."

# 查看路由历史记录
claw router history --limit=10

# 显示成本节省情况
claw router savings

# 打开仪表盘
claw router dashboard

# 订阅专业版
claw router subscribe

工作原理

1. 拦截请求 —— 在每次 API 调用前介入
2. 分析复杂度 —— 对任务进行 0.0（简单）至 1.0（专家级）打分
3. 检查预算 —— 综合考虑当前支出限制
4. 选择模型 —— 按复杂度区间选择最优模型：
   • 简单（0.0–0.3）→ Haiku / GPT-3.5
   • 中等（0.3–0.6）→ Sonnet / GPT-4-Turbo
   • 复杂（0.6–0.8）→ Opus / GPT-4
   • 专家级（0.8–1.0）→ Opus / GPT-4
5. 执行路由 —— 将请求发送至所选模型
6. 从结果中学习 —— 追踪成功率并动态调整策略

复杂度评分机制

哪些因素使任务更复杂？

• 上下文长度（上下文越长，复杂度越高）
• 是否含代码（代码分析得分更高）
• 是否含错误信息（调试类任务更复杂）
• 任务类型（写作 < 编程 < 推理 < 研究）
• 问题复杂性（多步骤、嵌套逻辑）
• 具体程度（模糊请求需更强模型支撑）

示例：

简单（0.0–0.3）→ Haiku：

• "当前时间是多少？"
• "格式化这段 JSON"
• "修复变量名中的拼写错误"

中等（0.3–0.6）→ Sonnet：

• "重构此类以使用接口"
• "为该函数编写单元测试"
• "解释 React Hooks 的工作原理"

复杂（0.6–0.8）→ Opus：

• "调试这个多线程竞态条件"
• "设计一个可扩展的缓存策略"
• "优化该算法的性能"

专家级（0.8–1.0）→ Opus：

• "设计一个分布式系统架构"
• "解决这个新颖的算法问题"
• "从多个来源开展研究并综合结论"

典型应用场景

• 自动降低 30–50% 的模型成本
• 停止手动切换不同模型
• 面向预算控制的智能路由
• 基于历史模式学习最优模型选择策略
• 长期追踪支出与投资回报率（ROI）

成本节省示例

示例 1：开发工作

未启用智能路由时：
- 每日 100 次请求调用 Opus
- 单次请求 $0.015
- 月度成本：$45

启用智能路由后：
- 30 次请求调用 Haiku（$0.90）
- 50 次请求调用 Sonnet（$7.50）
- 20 次请求调用 Opus（$9.00）
- 月度成本：$17.40

节省：$27.60/月（61%）

示例 2：客户支持

未启用智能路由时：
- 每日 500 次请求调用 GPT-4
- 月度成本：$300

启用智能路由后：
- 400 次请求调用 GPT-3.5（$24）
- 80 次请求调用 GPT-4-Turbo（$24）
- 20 次请求调用 GPT-4（$12）
- 月度成本：$60

节省：$240/月（80%）

Agent 经济体系

Agent 可自主评估是否值得升级至专业版：

• 成本：每月 0.5 USDT
• 价值：节省模型成本的 30–50%
• 投资回报率（ROI）：若月节省额超过 0.5 USDT，则专业版可完全回本

ROI 示例：

每日处理 100 次请求的 Agent：
- 未启用路由：$45/月
- 启用路由：$17.40/月
- 节省：$27.60/月
- 专业版费用：$0.50/月
- 净收益：$27.10/月
- ROI：5,420%

经济合理性说明：只要路由决策每月节省的模型成本超过 0.5 USDT，专业版即可实现自偿付。Agent 可通过 x402 自主完成支付，无需人工审批。

详见 AGENT-PAYMENTS.md 获取 x402 集成细节。

模式学习

智能路由器持续学习您的使用行为：

学习示例：

检测到模式："调试 Python 错误"
历史记录：Haiku 失败 3 次，Sonnet 成功 5 次
学习结论：Python 调试任务始终优先选用 Sonnet+

下次请求："调试此 Python 错误..."
→ 自动路由至 Sonnet，而非 Haiku

学习内容包括：

• 任务类型模式（如调试、重构、写作）
• 复杂度模式（各复杂度层级下表现最佳的模型）
• 预算模式（何时降级模型、何时必须保障质量）
• 服务商模式（哪些服务商更适合您的特定任务）

与其他工具集成

记忆系统

• 将路由模式作为持久化记忆存储
• 跨会话复用成功模型选择经验
• 实现最高学习效率

上下文优化器

• 组合使用可实现总计 60–80% 的成本降低
• 压缩上下文（减少 40–60% token 消耗）
• 路由至更低成本模型（节省 30–50% 成本）
• 协同作用 = 最大化效率

成本治理器（Cost Governor）

• 智能路由器优化模型选择
• 成本治理器强制执行硬性支出上限
• 二者协同 = 最强成本管控能力

# 安装完整效能套件
claw skill install openclaw-memory
claw skill install openclaw-context-optimizer
claw skill install openclaw-smart-router

隐私保护

• 所有数据本地存储于 ~/.openclaw/openclaw-smart-router/
• 不依赖任何外部服务器，无遥测（telemetry）收集
• 全部路由操作均在本地完成（不发起任何 API 请求）
• 开源代码，欢迎自行审计

仪表盘

通过 Web UI 访问地址：http://localhost:9093：

• 实时路由决策流
• 复杂度分布图表
• 模型选择占比分析
• 长期成本节省趋势
• ROI 计算结果
• 模式学习洞察
• 预算使用追踪
• 许可证状态

ROI 追踪

智能路由器自动计算投资回报率：

$ claw router savings

成本分析（近 30 天）
────────────────────────────────
路由决策总数：2,847  
平均复杂度：0.45  

模型使用分布：
- Haiku：42%（$3.60）
- Sonnet：49%（$21.00）
- Opus：9%（$11.12）

实际总成本：$35.72  
未启用智能路由时预估成本：$128.12  
节省：$92.40（72%）

专业版费用：$0.50/月  
净收益：$91.90/月  
ROI：18,380% 🎉

系统要求

• Node.js 18+
• OpenClaw v2026.1.30+
• 操作系统：Windows、macOS、Linux
• 可选：OpenClaw 记忆系统（推荐）
• 可选：OpenClaw 上下文优化器（强烈推荐）

API 参考文档

# 分析复杂度
POST /api/analyze
{
  "agent_wallet": "0x...",
  "query": "任务描述...",
  "context_length": 1500
}

# 响应：
{
  "complexity": 0.65,
  "recommended_model": "claude-sonnet-4-5",
  "recommended_provider": "anthropic",
  "estimated_cost": 0.008,
  "reasoning": "中等复杂度代码任务"
}

# 获取路由统计信息
GET /api/stats?agent_wallet=0x...

# 获取节省分析报告
GET /api/savings?agent_wallet=0x...

# 获取已学习模式列表
GET /api/patterns?agent_wallet=0x...

# x402 支付相关端点
POST /api/x402/subscribe
POST /api/x402/verify
GET /api/x402/license/:wallet

预算感知能力

智能路由器严格遵守您的预算限制：

预算层级：

• 单次请求上限（默认 $0.50）
• 日预算上限（默认 $5.00）
• 月预算上限（默认 $100.00）

预算策略：

• 保守型：在可行前提下优先选择更低成本模型
• 均衡型：采用推荐模型，同时严守硬性预算上限
• 质量优先型：优先选择最优模型，预算约束为软性限制

预算超限处理逻辑：

若日预算已达上限：
  → 降级至最便宜且可用的模型
  → 向用户发出预算约束警告
  → 记录预算事件日志

支持的模型

Anthropic：

• claude-haiku-4-5（简单）
• claude-sonnet-4-5（中等）
• claude-opus-4-5（复杂）

OpenAI：

• gpt-3.5-turbo（简单）
• gpt-4-turbo（中等）
• gpt-4（复杂）

Google：

• gemini-1.5-flash（简单）
• gemini-1.5-pro（中等/复杂）

自定义服务商：

• 轻松配置您自己的模型及对应成本参数

统计信息示例

智能路由器统计（30 天）
────────────────────────────────
总决策数：2,847  
平均复杂度：0.45  

复杂度分布：
- 简单（0.0–0.3）：42%  
- 中等（0.3–0.6）：37%  
- 复杂（0.6–0.8）：15%  
- 专家级（0.8–1.0）：6%  

模型使用分布：
- Haiku：1,200 次（42%）  
- Sonnet：1,400 次（49%）  
- Opus：247 次（9%）  

成本：$35.72（对比未启用时 $128.12）  
节省：72%（$92.40/月）  

模式学习成果：
- 已识别模式：23 个  
- 成功率：94%  
- 模式应用次数：342 次

经济合理性分析

是否应升级至专业版？

请估算您的潜在节省：

当前日请求量 × 单次请求平均成本 = 月度成本  
应用 30–50% 节省比例 = 实际节省金额  
若节省金额 > 0.5 USDT/月 → 专业版可实现自偿付

典型节省规模：

• 轻量使用（10–20 次/天）：$3–8/月 → 净利润 $2.50–7.50
• 中等使用（50–100 次/天）：$20–45/月 → 净利润 $19.50–44.50
• 重度使用（200+ 次/天）：$100+/月 → 净利润 $99.50+

ROI 随使用规模扩大而显著提升。

相关链接

• 完整文档
• 路由指南
• Agent 支付指南
• GitHub 仓库
• ClawHub 页面

由 OpenClaw 社区构建 | 首款支持 x402 支付的智能模型路由器