ClawRouter

让智能体自动选最划算的模型，支付也顺手搞定

开源 🏷️定价信息待确认 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 653 👀 关注 67

GitHub ↗

GitHub 星标 ★ 6656

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类智能体

开发团队BlockRunAI

GitHubhttps://github.com/BlockRunAI/ClawRouter

定价模式🏷️定价信息待确认

价格说明开源项目，提供本地部署，定价信息待确认。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai,ai-agents,anthropic,cost-optimization,deepseek,gemini,llm,llm-router,micropayments,openai,openclaw,smart-routing,stablecoin-payment,stablecoin-payments,usdc,x402

GitHub 星标★ 6656

上线时间2026-02-03 00:00:00

代码更新2026-11-06

仓库体积163.4 MB

本站数据更新2026-11-08

维护状态活跃

收录时间2026-08-09

浏览次数6

项目介绍

ClawRouter 是一个面向自主智能体的 LLM 路由层，核心解决多模型选择与成本控制问题。它内置 66 个模型（其中 8 个免费），通过本地路由实现亚毫秒级延迟，并支持基于 x402 协议的 USDC 微支付，覆盖 Base 和 Solana 链。项目用 TypeScript 编写，提供智能路由、成本优化和支付集成能力，让开发者无需手动管理多个 API 密钥和计费，即可为智能体动态选择最优模型。其核心能力包括：本地路由决策、多模型适配（OpenAI、Anthropic、DeepSeek、Gemini 等）、以及链上支付自动化，适合需要高性价比和低延迟的 AI Agent 应用。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 6656

技术标签

ai ai-agents anthropic cost-optimization deepseek

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：入门约 10 分钟部署方式：命令行工具 6 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

安装后可用的 clawrouter 命令行工具（README 节选未给出安装命令，需按官方仓库说明安装）
可选：BlockRun API key，在 user.blockrun.ai 用 Google 登录、Credits 充值后在 API Keys 处签发
可选：Solana 或 Base 链上的 USDC 钱包，作为默认支付方式，首次运行自动生成，无需手动配置
只用免费模型时无需注册、无需 API key、无需钱包

安装与启动步骤

1安装命令行工具

本轮 README 节选未包含安装命令，请先按官方仓库说明完成安装；安装后应在终端能直接调用 clawrouter。
2用 API key 登录

在 user.blockrun.ai 注册充值并签发 key，把示例值换成你自己的 brk_live_ 开头密钥。登录后 ClawRouter 优先走 API key 计费。
```
clawrouter login brk_live_Ab3xQ9f8c1
```
3确认当前计费模式

输出当前模式、所用网关、掩码后的密钥以及账户余额，用于确认已从钱包模式切到 API key 模式。
```
clawrouter status
```
4校验密钥是否可用

拿密钥向网关做一次真实校验；返回 401 说明密钥已被撤销或输入有误，需要重新签发。
```
clawrouter doctor
```
5对账本地账单

把本地使用记录与 BlockRun 官方账本（GET /v1/usage）按网关请求 id 比对，默认看最近 7 天。
```
clawrouter reconcile
```
6切回钱包支付

删除本地保存的 API key，重新走默认的 USDC 钱包逐次支付方式；后续所有命令行为保持一致。
```
clawrouter logout
```

关键配置

配置项	必填	说明	示例
`~/.blockrun/.api-key`	否	API key 在本地保存的位置，由 login 写入、logout 删除	`brk_live_Ab3xQ9f8c1`
`Authorization: Bearer`	否	用 OpenAI 兼容 SDK 直连 api.blockrun.ai 时的鉴权头	`Bearer brk_live_Ab3xQ9f8c1`
`x-api-key`	否	用 Anthropic SDK 直连 api.blockrun.ai 时的鉴权头	`brk_live_Ab3xQ9f8c1`
`gateway`	否	钱包模式默认 sol.blockrun.ai（Solana），Base 用 blockrun.ai；API key 模式用 api.blockrun.ai	`sol.blockrun.ai`
`model`	否	指定要使用的模型，可固定为免费模型以零成本运行	`free/nemotron-3.5-lightning`

如何确认成功

执行 clawrouter status 能显示当前模式、网关、掩码密钥与余额，且 clawrouter doctor 校验通过无 401，即表示配置成功。

常见问题

Q：没有钱包或不想用加密货币，能用吗？

A：可以。免费模型开箱即用，无需注册、无需密钥、无需钱包；要付费模型也可只用信用卡在 user.blockrun.ai 充值换取 API key。

Q：免费模型有哪些、怎么切换？

A：README 标注有 6 个免费模型，直接指定其中一个为模型即可，例如 free/nemotron-3.5-lightning，全过程不产生费用、不需要余额。

Q：clawrouter doctor 返回 401 怎么办？

A：401 表示密钥已被撤销或输入错误，回到 user.blockrun.ai 的 API Keys 页面重新签发一个 key，再用 clawrouter login 登录。

Q：reconcile 显示金额对不上是出错了吗？

A：要分开看：金额不一致说明本地价目表与网关有偏差；退出码 2 表示有本机未发起的扣费，可能是同一密钥在别的机器使用，否则值得排查。

Q：本地累计金额为何总是少于信用卡账单？

A：差额恰好是充值手续费，它在购买时收取，不会作为账本条目出现；这属于算术上的正常差，不是记账错误。

注意事项

登录 API key 后 ClawRouter 会优先使用 API key，clawrouter login 与 clawrouter logout 可随时在 API key 与钱包两种计费方式间切换。
钱包模式通过 x402 协议按次支付 USDC，非托管，覆盖 Solana 与 Base 两条链，每笔结算费约 $0.001（含链上 gas）。
同一个 brk_live_ 密钥可直接用于 api.blockrun.ai，OpenAI 客户端用 Authorization: Bearer，Anthropic 客户端用 x-api-key。
reconcile 中仍处于 pending pricing 的行不计入总额，也不会被当成 $0 统计。

核心亮点

内置 66 个模型含 8 个免费，路由选择灵活且成本透明
本地路由延迟 <1ms，对实时交互场景友好
原生支持 USDC 微支付，打通 Base/Solana 链上结算

不足之处

依赖链上支付，对非 Web3 用户有使用门槛
文档/社区待观察

适用场景

AI Agent 需要动态调用多种模型以平衡成本与质量
去中心化应用内嵌 AI 功能，需自动支付模型费用
高频低延迟场景，如实时对话或工具调用

替代项目

OpenRouter、LiteLLM、Kong AI Gateway

上一篇：Claude-Code-Agent-Monitor

下一篇：agentcat-python-sdk