NadirClaw 是一个源码可获取、可自托管的 LLM 路由器与 AI 成本优化器，由 Nadir 团队开发，是托管版 Nadir Pro 的自托管核心。其目标是在保证回答质量的前提下，把每个提示路由到能够可靠回答的最便宜模型，并验证输出，必要时才升级到更强模型。
用途与定位 NadirClaw 面向希望降低 LLM API 成本、同时保持回答质量的开发者与团队。它作为 OpenAI 兼容代理运行，可被 Claude Code、Cursor、Continue、Aider、Windsurf、Codex、OpenClaw、Open WebUI 以及任何兼容 OpenAI 接口的客户端使用。它在本机运行，API 密钥不离开用户机器，直接路由到各提供商，不经过第三方代理。
主要能力 路由：使用约 10ms 的句子嵌入分类器预测能够回答的最小模型，并优先发送到该模型。路由修饰符（如智能体工具循环、推理标记、视觉内容、长上下文）可覆盖评分，强制使用更强层级。 验证：在返回前用质量启发式（拒绝回答、截断、JSON 格式失败等）对便宜模型的回答打分。 升级：若回答低于接受阈值（τ = 0.80），自动升级到下一个最佳模型。 分类器：可选 binary（默认，约 10ms 质心分类器）或 distilbert（三分类微调 DistilBERT，原生预测 simple/mid/complex），通过 NADIRCLAW_COMPLEXITY_ANALYZER 选择。 分层路由：支持 simple / mid / complex 三层，阈值可配置（NADIRCLAW_TIER_THRESHOLDS），可设置 NADIRCLAW_MID_MODEL 提供中间层。 N 层 YAML 配置：一个分类头支持任意层数，默认配置 n2_default.yaml 为两层级联，可通过 NADIRCLAW_TIERS_PROFILE 切换，自定义 YAML 配置可在 30 秒内热重载。 级联规则引擎：声明式 YAML 规则实现按提示覆盖，如 force_escalate、set_threshold、force_cheap、set_max_tokens，支持热重载。 智能体任务检测：自动检测工具使用、多步循环和智能体系统提示，强制使用复杂模型。 推理检测：识别需要思维链的提示，路由到推理优化模型。 视觉路由：自动检测消息中的图像内容，路由到支持视觉的模型（GPT-4o、Claude、Gemini）。 路由配置：auto、eco、premium、free、reasoning，可按请求选择成本/质量策略。 模型别名：使用 sonnet、flash、gpt4 等短名称代替完整模型 ID。 会话持久化：为多轮对话固定模型，避免中途切换。 上下文窗口过滤：对话过长时自动切换到上下文窗口更大的模型。 回退链：模型失败（429、5xx、超时）时，按可配置链依次回退直到成功。 流式支持：完整 SSE 流式，兼容 OpenClaw、Codex 等流式客户端。 原生 Gemini 支持：通过 Google GenAI SDK 直接调用 Gemini 模型。 OAuth 登录：使用 nadirclaw auth <provider> login 使用订阅，无需 API 密钥。 多提供商：支持 Gemini、OpenAI、Anthropic、Ollama 以及任何 LiteLLM 支持的提供商。 OpenAI 兼容 API：/v1/chat/completions 端点，可替换任何兼容 OpenAI 聊天补全 API 的工具。 Anthropic 兼容 API：/v1/messages 端点，让 Claude Code 等 Anthropic 原生客户端通过 NadirClaw 路由，流式逐字节转发。 请求报告：nadirclaw report 提供按模型和按天的成本明细、异常标记、过滤、延迟统计、层级明细和 token 用量。 日志导出：nadirclaw export --format csv|jsonl --since 7d 用于离线分析。 原始日志：可选 --log-raw 捕获完整请求/响应内容用于调试和重放。 Prometheus 指标：内置 /metrics 端点，包含请求计数、延迟直方图、token/成本总计、缓存命中和回退跟踪。 OpenTelemetry 追踪：可选分布式追踪，遵循 GenAI 语义约定。 成本节省计算器：nadirclaw savings 显示已节省金额及月度预测。 支出跟踪与预算：实时按请求成本跟踪，支持日/月预算限制，通过 nadirclaw budget 告警，可选 webhook 和 stdout 通知。 提示缓存：内存 LRU 缓存相同聊天补全，跳过冗余 LLM 调用，TTL 和最大大小可配置。 实时仪表盘：nadirclaw dashboard 终端界面，或访问 http://localhost:8856/dashboard 查看 Web UI。 GitHub Action：doramirdor/nadirclaw-action 用于 CI/CD 流水线。
使用方式 安装：推荐一行安装命令，将仓库克隆到 ~/.nadirclaw，创建虚拟环境、安装依赖并将 nadirclaw 加入 PATH，再次运行可更新。也可从源码安装。 设置：运行交互式设置向导 nadirclaw setup，选择提供商、输入 API 密钥、为每个路由层级选择模型。然后启动路由器 nadirclaw serve，默认监听 http://localhost:8856，默认使用 Gemini 3 Flash 处理简单请求、OpenAI Codex 处理复杂请求。若跳过 setup，serve 首次启动时会提示运行。 配置：从 ~/.nadirclaw/.env 加载配置，若不存在则回退到当前目录的 .env。凭据提供顺序为：OpenClaw 存储令牌、NadirClaw 存储凭据、环境变量。共享服务器上可通过环境变量将环境变量提前。 Docker：可运行 NadirClaw + Ollama 零成本全本地，容器监听所有接口，需设置 NADIRCLAW_AUTH_TOKEN，客户端以 Authorization: Bearer <token> 发送。也可单独运行 NadirClaw。
适用场景 适合希望降低 LLM API 成本、需要自托管路由、使用多种模型提供商、或希望在不改变现有 OpenAI 兼容客户端的情况下优化成本的开发者和团队。典型编码会话中 60-70% 的提示较简单，可由成本低 10-20 倍的模型处理。
限制 NadirClaw 采用 PolyForm Noncommercial 1.0.0 许可，是源码可获取而非开源，仅限非商业用途。商业用途需使用托管版 Nadir Pro。分类器精度与 Nadir Pro 的训练分类器 + DeBERTa 验证器不同，NadirClaw 使用更简单的二元质心分类器，以一定精度换取零训练成本。文档中 RouterBench 数据为参考辅助研究上限，非生产性能或节省预测。Nadir 未发布通用生产节省或质量百分比，直到在带结果标签的客户流量上测量。DistilBERT 分类器首次使用需下载约 256MB 模型，下载失败会回退到二元分类器。Morph 远程分类器为严格可选，需 MORPH_API_KEY，失败时回退到本地二元分类器。
