
【免费下载链接】ClawRouterThe agent-native LLM router for autonomous agents. Every frontier model behind one wallet, 1ms local routing, USDC payments on Base Solana via x402.项目地址https://gitcode.com/gh_mirrors/cl/ClawRouter点击查看免费下载本指南讲解如何在 OpenClaw 网关中把你已有的 LLM 订阅Claude Pro/Max、ChatGPT Plus 等配置为主模型提供方并把 ClawRouterblockrun/auto的 x402 USDC 微支付作为自动故障转移兜底——当订阅触发限流、配额耗尽或鉴权失败时请求自动落到 ClawRouter 智能路由用最便宜的可用模型完成回答。读完本文你将掌握为什么订阅支持不内建在 ClawRouter 里、故障转移的完整触发链路、从安装到验证的四步配置、多 fallback 与按 Agent 隔离的进阶玩法以及配套的监控与成本测算方法。为什么订阅支持不直接内建在 ClawRouter 中ClawRouter 团队经过权衡后决定不在 ClawRouter 内部直接集成订阅支持原因可以归纳为四点1. 服务条款ToS合规Claude Code、ChatGPT Plus 等大多数订阅 ToS 都是为个人使用设计的通过代理/API 服务转发订阅流量可能违反提供商协议保持 ClawRouter 对全体用户合规、低风险是架构决策的底线。2. 安全与隐私集成订阅意味着 ClawRouter 需要接触你的凭据/会话派生外部进程如直接拉起 Claude CLI会引入安全风险更好的做法是把认证留在OpenClaw 层由你完全掌控。3. 维护与灵活性每家订阅提供商的 API、CLI 与认证方式各不相同OpenClaw 本身已有健壮的 provider 系统处理这类差异在 ClawRouter 中重复造轮子只会增加复杂度没有增量价值。4. 更优的架构OpenClaw 原生故障转移机制更灵活、更强大对任意provider 生效不限于 ClaudeClawRouter零代码改动即可接入凭据始终掌握在你手中。从源码结构看这一分工也体现在插件边界上openclaw.plugin.json 中blockrun/clawrouter插件只声明了apiKey、walletKey、routing三个配置项把模型选择交给 OpenClaw 的 provider 体系ClawRouter 只负责路由与支付——这正是订阅认证归 OpenClaw、成本优化归 ClawRouter的体现。工作原理OpenClaw 模型回退链OpenClaw 内置的model fallback chain模型回退链会在主 provider 失败时自动尝试备选 provider完整流程如下User Request ↓ Primary Provider例如通过 OpenClaw 使用的 Claude 订阅 ↓ 限流 / 配额耗尽 / 鉴权失败 OpenClaw 检测到失败 ↓ Fallback Chain按顺序逐一尝试 ↓ ClawRouterblockrun/auto ↓ 智能路由挑选最便宜且胜任的模型 ↓ 向 BlockRun API 发起 x402 微支付 ↓ 响应返回给用户关键收益✅ 自动故障转移无需人工介入✅ 兼容 OpenClaw 支持的任意订阅 provider✅ 尊重 provider ToS认证由你自己配置不经代理/包装✅ ClawRouter 专注成本优化前置条件已安装 OpenClaw Gateway 并启用 ClawRouter 插件npm install -g openclaw openclaw plugins install blockrun/clawrouter安装时插件会写入~/.openclaw/openclaw.json的plugins.entries[blockrun-clawrouter]详见 src/openclaw-plugin-config.ts 的配置迁移逻辑。在 OpenClaw 中配置好你的订阅Claude使用claude setup-token或 API keyOpenAI设置OPENAI_API_KEY环境变量其他参考 OpenClaw 的 provider 文档给 ClawRouter 钱包充值用于故障转移兜底openclaw gateway logs | grep Wallet: # 向显示的地址在 Base 网络上发送 USDC关于钱包ClawRouter 支持 BaseEVM与 Solana 双链均为 USDC-only新安装默认 Solana既有安装保留 Basedocs/configuration.md。也可改用BLOCKRUN_API_KEYbrk_live_…走信用卡充值的账户额度模式两种支付方式互斥、API key 优先级更高docs/configuration.md。四步配置订阅为主、ClawRouter 兜底Step 1设置主模型你的订阅# 方案 A使用 Claude 订阅 openclaw models set anthropic/claude-sonnet-4.6 # 方案 B使用 ChatGPT Plus经 OpenAI provider openclaw models set openai/gpt-4o # 方案 C使用任意其他 provider openclaw models set provider/model这些模型 ID 在 ClawRouter 的别名表中都有对应解析sonnet-4.6→anthropic/claude-sonnet-4.6、gpt→openai/gpt-4o等且blockrun/前缀会被自动剥离src/models.ts 的resolveModelAlias所以 OpenClaw 侧写blockrun/xxx与直接写模型 ID 都能正确落到 BlockRun 目录。Step 2把 ClawRouter 加入回退链# 添加 blockrun/auto 走智能路由推荐 openclaw models fallbacks add blockrun/auto # 或者指定具体模型 openclaw models fallbacks add blockrun/google/gemini-2.5-problockrun/auto是一个虚拟路由 profileSmart Router – Balanced在 src/models.ts 的BLOCKRUN_MODELS中定义为 0 定价的元模型由代理在请求时替换为真实模型——这也是它可以充当万能兜底的原因。Step 3验证配置openclaw models show预期输出Primary: anthropic/claude-sonnet-4.6 Fallbacks: 1. blockrun/autoStep 4测试故障转移可选暂时耗尽订阅配额或等待触发限流发起一个请求——OpenClaw 应自动故障转移到 ClawRouter检查日志openclaw gateway logs | grep -i fallback\|blockrun高级配置配置多个回退openclaw models fallbacks add blockrun/google/gemini-2.5-flash # 快速且便宜 openclaw models fallbacks add blockrun/deepseek/deepseek-chat # 更便宜 openclaw models fallbacks add blockrun/free/nemotron-3.5-lightning # 免费档free/nemotron-3.5-lightning是免费档默认模型在 src/models.ts 的free别名与 src/proxy.ts 的免费级联头部都有定义即使钱包余额为空代理也会走pickFreeModel()的免费级联兜底而不报错src/proxy.ts——这正好可以消除下文的Wallet empty类错误。按 Agent 隔离配置编辑~/.openclaw/openclaw.json{ agents: { main: { model: { primary: anthropic/claude-opus-4.6, fallbacks: [blockrun/auto] } }, coding: { model: { primary: anthropic/claude-sonnet-4.6, fallbacks: [blockrun/google/gemini-2.5-pro, blockrun/deepseek/deepseek-chat] } } } }这样可以让不同 Agent 拥有不同的订阅优先 不同成本档位兜底策略例如 coding Agent 的兜底优先质量、普通 Agent 的兜底走智能路由。基于 Tier 的配置ClawRouter 智能路由使用blockrun/auto时ClawRouter 会自动对请求分类并挑选最便宜且胜任的模型SIMPLE查询 → Gemini 2.5 Flash、DeepSeek Chat约 $0.0001/次MEDIUM查询 → GPT-4o-mini、Gemini Flash约 $0.001/次COMPLEX查询 → Claude Sonnet、Gemini Pro约 $0.01/次REASONING查询 → DeepSeek R1、o3-mini约 $0.05/次分类不是拍脑袋blockrun/router-coreV3.4ClawRouter 构建时内联先用 15 维加权打分器把请求映射到 SIMPLE/MEDIUM/COMPLEX/REASONING 档位再按任务形态打标签每个档位有策展好的主模型 回退链完整链条见 docs/routing-profiles.md。例如 AUTO profile 下 COMPLEX 档以google/gemini-3.1-pro为主、回退链覆盖 Gemini/Sonnet/Grok/GPT 等多个独立基础设施的模型——这意味着订阅耗尽后的兜底请求也会自带一层模型级故障转移。更深层的分类器原理14 维度加权、sigmoid 置信度校准、46 模型基准测试可参考 docs/smart-llm-router-14-dimension-classifier.md。监控与排障检查故障转移是否生效# 实时日志 openclaw gateway logs --follow | grep -i fallback\|blockrun\|rate.limit\|quota # 检查 ClawRouter 代理日志 openclaw gateway logs | grep ClawRouter成功指标✅ 出现Rate limit reached或Quota exceeded→ 主 provider 失败✅ 出现Trying fallback: blockrun/auto→ 故障转移已触发✅ 出现ClawRouter: Success with model→ 故障转移成功常见问题问题一故障转移从不触发症状一直使用主模型从不切到 ClawRouter。排查步骤确认已配置回退openclaw models show确认主 provider 确实在失败去 provider 后台查看配额/限流情况检查 OpenClaw 日志中的鉴权错误问题二故障转移时报 Wallet empty症状故障转移触发了但 ClawRouter 返回余额错误。解决方案检查 ClawRouter 钱包余额openclaw gateway logs | grep Balance:在 Base 网络充值 USDC确认钱包密钥配置正确BLOCKRUN_WALLET_KEY环境变量或插件walletKey见 docs/configuration.md另外值得知道的是当前版本中即使钱包为空代理也会自动回退到免费模型级联FREE_MODELS从free/nemotron-3.5-lightning到free/llama-3.2-11b-vision见 src/proxy.ts所以余额不足导致请求彻底失败的场景已大幅减少。若你希望给故障转移兜底请求设置硬性金额上限还可启用maxCostPerRun 免费级联graceful模式自动降级 premium → auto → eco → free配置见 docs/configuration.md。问题三故障转移慢高延迟症状切换到 ClawRouter 时有 5-10 秒延迟。原因OpenClaw 在故障转移前会先尝试多个鉴权 profile。解决方案减少鉴权 profile 重试次数见 OpenClaw 配置直接把blockrun/auto作为主模型换取更快响应接受该延迟作为更廉价请求的代价成本分析示例场景用量模式每天 100 个请求50% 命中 Claude 订阅配额被限流50% 走 ClawRouter 故障转移无故障转移全量走 Anthropic API$50/月100% API 计费启用故障转移Claude 订阅$20/月覆盖 50% 请求ClawRouter x402约 $5/月50 个请求走智能路由合计$25/月节省 50%注意以上为文档给出的示例测算实际节省取决于你的用量、订阅档位与兜底模型选择从源码看ClawRouter 的智能路由定价以 src/models.ts 中BLOCKRUN_MODELS的每百万 token 单价input/output为准且支持free免费档真实成本可能进一步下探。什么时候值得这样做✅适合你已有个人使用的订阅偶尔超出配额/限流想在不多管理 API key 的情况下优化成本❌不适合需要 100% 可靠性订阅本身有限流偏好单一 provider不想引入故障转移复杂度用量很低每天少于 10 个请求FAQQ这样用会违反订阅的 ToS 吗A订阅是在 OpenClaw 中直接用你自己的凭据配置的ClawRouter 只在订阅失败后才收到请求——这类似于你自己轮换多个 API key。不过每家 provider 的 ToS 不同使用前请先确认你自己的订阅条款。Q可以同时用多个订阅吗A可以配置多个 provider 并串联回退链openclaw models set anthropic/claude-opus-4.6 openclaw models fallbacks add openai/gpt-4o # ChatGPT Plus openclaw models fallbacks add blockrun/auto # x402 作为最终兜底Q支持 Claude Max API Proxy 吗A支持把代理配置为 OpenClaw 的自定义 provider再把blockrun/auto加入回退链即可。Q这和 PR #15把 Claude CLI 直接集成进 ClawRouter有何不同A本方案兼容任意 provider不限于 Claude、尊重 provider ToS无代理/包装、使用 OpenClaw 原生故障转移更可靠、ClawRouter 零维护负担。延伸阅读ClawRouter 路由 Profile 与定价AUTO/ECO/PREMIUM/AGENTIC 四套 profile 的完整 tier 回退链与打分权重ClawRouter 智能路由分类器46 模型基准与 14 维加权分类原理ClawRouter 配置参考钱包/双链切换、环境变量、spend control、程序化调用插件配置 Schema见 openclaw.plugin.json赞分享【免费下载链接】ClawRouterThe agent-native LLM router for autonomous agents. Every frontier model behind one wallet, 1ms local routing, USDC payments on Base Solana via x402.项目地址https://gitcode.com/gh_mirrors/cl/ClawRouter点击查看免费下载相关推荐ClawRouter 智能 LLM 路由实战指南面向自主智能体的本地路由、15 维模型选择与 x402 USDC 支付ClawRouter 智能 LLM 路由实战指南面向自主智能体的本地路由、15 维模型选择与 x402 USDC 支付 本文是 ClawRouter开源、M从 100 个 OpenClaw Issue 看 OpenRouter 的结构性缺陷ClawRouter 本地路由与 x402 微支付架构对比解析从 100 个 OpenClaw Issue 看 OpenRouter 的结构性缺陷ClawRouter 本地路由与 x402 微支付架构对比解析 OpenRClawRouter Worker Network 实现方案用 x402 微支付把 ClawRouter 节点变成去中心化 HTTP 健康检查工人网络ClawRouter Worker Network 实现方案用 x402 微支付把 ClawRouter 节点变成去中心化 HTTP 健康检查工人网络 本文围上一篇TitanHide实战应用绕过VMProtect和Themida反调试的终极指南下一篇MediaCrawler7大平台数据采集的终极解决方案创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考