1. 项目定位与用途
ClawRouter 是专为自主 AI 代理设计的开源 LLM 路由器，作为 OpenClaw 平台的插件运行。其核心用途是让 AI 代理能够独立、高效且低成本地调用各种大语言模型进行推理或生成，无需任何人工干预。它通过本地智能路由选择最具成本效益的模型，并处理认证与支付，是构建代理优先应用的关键基础设施。
项目档案插件 / 扩展
ClawRouter：自主 AI 代理的 LLM 路由器 - 开源智能路由与 USDC 支付解决方案
ClawRouter 是专为自主 AI 代理设计的开源 LLM 路由器，支持 55+ 模型本地智能路由，使用钱包签名认证和 x402 USDC 支付，降低 AI 推理成本高达 92%。本页提供安装指南、使用方法和架构详解。
AI 总结
ClawRouter 是专为自主 AI 代理设计的开源 LLM 路由器，通过本地智能路由、钱包签名认证和 x402 USDC 支付，使代理能独立调用 55+ 模型，降低推理成本高达 92%。
中文项目介绍
ClawRouter 是一个面向自主 AI 代理的开源智能 LLM 路由器，其核心价值在于解决传统 LLM 路由方案对人工操作的依赖，使代理能够完全自治地运行。
它解决了代理无法注册账户、管理 API 密钥或使用信用卡支付的根本问题，转而使用本地生成的钱包签名进行认证，并通过 x402 协议实现 USDC micropayments。
该项目适用于需要高效低成本 LLM 推理的自主代理系统、去中心化应用，以及任何希望大幅降低 AI API 成本的场景，尤其与 OpenClaw 平台深度集成。
技术层面，ClawRouter 在本地以低于 1ms 的延迟分析请求的 15 个维度，智能路由到最具成本效益的模型；采用策略模式实现可插拔路由逻辑，双层分类机制（规则匹配 + LLM 后备）兼顾效率与准确性；并通过上下文压缩等技术进一步优化 token 使用。
详细信息与使用说明
2. 解决的问题
传统 LLM 路由器（如 OpenRouter、LiteLLM）依赖人类开发者操作：需要注册账户、获取 API 密钥、手动选择模型，并使用信用卡支付。而自主 AI 代理只能签署交易，无法完成上述步骤。ClawRouter 彻底消除了这些人工依赖：使用本地钱包签名替代 API 密钥，通过 x402 协议实现 USDC 自动 micropayments，并完全本地化路由决策，使代理真正实现自治运行。
3. 适用场景
主要适用于：1）自主 AI 代理需要频繁调用 LLM 且对成本敏感的场景；2）去中心化或代理优先的应用，希望避免传统支付和认证体系；3）生产环境中希望显著降低 LLM API 成本（最高 92%）的项目；4）基于 OpenClaw 平台构建的代理系统，需要智能路由、预算控制和错误处理能力。
4. 安装方式
通过 npm 安装：运行命令 `npm install @blockrun/clawrouter`。该包提供 TypeScript 类型定义，并包含构建后的 dist 目录。仓库中未明确给出其他包管理器（如 yarn、pnpm）的安装命令，但理论上应兼容。安装后即可作为 OpenClaw 插件自动加载，或作为 Node.js 库导入使用。
5. 使用方式
有三种主要使用方式：1）作为 OpenClaw 插件：安装后，OpenClaw 会自动发现并加载 ClawRouter，代理的所有 LLM 请求将自动经过路由、认证和支付流程；2）作为 Node.js 库：在代码中导入 `@blockrun/clawrouter` 模块，调用其路由函数（如 `route`）处理请求，具体 API 需参考文档；3）作为 CLI 工具：使用 `clawrouter` 命令，但需先通过 `npm run build` 构建，具体子命令在仓库中未明确给出。
6. 实现特点与补充说明
ClawRouter 采用策略模式实现可插拔路由逻辑，默认 RulesStrategy 保证 <1ms 延迟。双层分类机制先通过多语言关键词规则快速匹配，必要时调用 LLM 进行精确 tier 判断并缓存结果。配置驱动设计，通过 DEFAULT_ROUTING_CONFIG 集中管理评分参数。模型选择器基于动态定价计算成本，并与基线比较得出节省比例。此外，内置 7 层上下文压缩可减少 15-40% token 使用。仓库中未明确列出 15 个路由维度的具体细节，但配置文件中包含相关参数。
思维导图
ClawRouter
核心架构
策略模式
双层分类
配置驱动
本地路由 <1ms
路由机制
15维度请求分析
规则分类器（多语言关键词）
LLM后备分类器（带缓存）
模型选择器（动态定价）
成本节省计算
认证与支付
钱包签名认证
x402协议集成
USDC micropayments
Base & Solana 支持
优化特性
7层上下文压缩
后备链与重试
促销时间窗口
错误分类处理
集成方式
OpenClaw 插件
Node.js 库
CLI 工具
常见问题
ClawRouter 是什么？它解决了什么问题？
ClawRouter 是一个开源的 LLM 路由器，专为自主 AI 代理设计。它解决了代理无法使用传统 LLM 路由服务的问题（如注册账户、管理 API 密钥、信用卡支付），通过本地路由、钱包签名认证和 USDC micropayments，使代理能完全独立地调用大语言模型。
如何安装 ClawRouter？
可以通过 npm 安装：运行 `npm install @blockrun/clawrouter`。安装后，它可作为 OpenClaw 插件自动加载，或作为 Node.js 库在代码中导入使用。如需使用 CLI 工具，需先运行 `npm run build` 进行构建。
ClawRouter 支持哪些模型和支付方式？
ClawRouter 支持 55+ 模型，包括 OpenAI、Anthropic、Google、xAI、DeepSeek 等提供商。支付方式采用 x402 协议，使用 USDC 进行 micropayments，支持 Base 和 Solana 网络，无需信用卡或传统支付渠道。
ClawRouter 如何降低 LLM 使用成本？
它通过本地智能路由分析请求的 15 个维度，在 1 毫秒内选择最具成本效益的模型，避免为简单任务支付高价；同时内置 7 层上下文压缩可减少 15-40% token 使用；此外，USDC micropayments 和去中心化支付也降低了交易成本，综合可节省高达 92% 的推理费用。
ClawRouter 必须与 OpenClaw 一起使用吗？
不是必须，但最佳集成方式是作为 OpenClaw 插件。安装后，OpenClaw 会自动加载 ClawRouter 处理代理的 LLM 请求。同时，它也可以作为独立的 Node.js 库或 CLI 工具使用，提供灵活的路由功能，但作为插件能获得最完整的自治代理体验。