NadirClaw对接5大AI工具:Cursor、Codex、Open WebUI、Continue、OpenClaw接入清单
NadirClaw对接5大AI工具:Cursor、Codex、Open WebUI、Continue、OpenClaw接入清单
NadirClaw 是一款自托管的 LLM 路由代理与 AI 成本优化工具:它把简单提示词自动转发给便宜的本地/低价模型,复杂任务才交给旗舰模型。作为 OpenAI 兼容代理,NadirClaw 可以一键接入 Cursor、Codex、Open WebUI、Continue、OpenClaw 五大 AI 工具——本文提供完整接入清单和逐步配置方法,帮你把每月 AI API 账单降下来。
先搞懂:NadirClaw 为什么能省钱?
NadirClaw 以本地代理方式运行在 http://localhost:8856,所有请求经过它时会自动执行三步:
- Route(路由):约 10ms 的嵌入式分类器判断提示词难度,简单请求发给便宜模型;
- Verify(验证):对廉价模型的回复做质量检查(拒绝、截断、JSON 格式失败等);
- Escalate(升级):质量不达标时自动升级到你配置的高级模型。
也就是说,你的 AI 工具完全不用改工作流,只需把 API 地址指向 NadirClaw,路由与省钱全自动发生。详细机制可参考 README.md 与 docs/multi-provider-routing.md。
通用三步启动:所有接入方式的前置步骤
pip install nadirclaw # 一键安装
nadirclaw setup # 交互式向导:选提供商、填 API Key、配模型
nadirclaw serve --verbose # 启动路由服务,监听 localhost:8856
向导会引导你配置简单档模型(如 Gemini Flash)与复杂档模型(如 Claude Sonnet)。配置完成后,下面 5 个工具按清单逐个接入即可。
五大工具接入清单速览 📋
| AI 工具 | 接入命令 | 配置写入位置 |
|---|---|---|
| Cursor | nadirclaw cursor onboard |
手动填写 Settings(OpenAI 兼容) |
| Codex | nadirclaw codex onboard |
~/.codex/config.toml(自动写入+备份) |
| Open WebUI | nadirclaw openwebui onboard |
管理后台手动添加连接 |
| Continue | nadirclaw continue onboard |
~/.continue/config.json(自动写入+备份) |
| OpenClaw | nadirclaw openclaw onboard |
~/.openclaw/openclaw.json(自动写入+备份) |
💡
onboard命令会在写入前自动备份原有配置(生成.backup-时间戳文件),可随时回滚。
Cursor 接入:设置里填 3 个值
- 启动路由:
nadirclaw serve - 运行
nadirclaw cursor onboard查看指引 - Cursor 中进入 Settings → Models,填写:
- API Key:
local - Base URL:
http://localhost:8856/v1 - Model name:
auto
- API Key:
保存后选 auto 模型即可享受智能路由。相关实现见 nadirclaw/cli.py。
Codex 接入:一条命令写配置
nadirclaw codex onboard # 自动写入 ~/.codex/config.toml
nadirclaw serve # 启动路由
codex # 直接运行 Codex
onboard 会把 ~/.codex/config.toml 写入 model_provider = "nadirclaw",Base URL 指向本地路由。想复用 ChatGPT 订阅而非 API Key,可先执行 nadirclaw auth openai login(OAuth 登录,令牌自动刷新)。源码见 nadirclaw/cli.py。
Open WebUI 接入:管理后台添加连接
- 运行
nadirclaw openwebui onboard查看步骤 - Open WebUI 中进入 Admin Settings → Connections → OpenAI → Add Connection
- 填写 URL:
http://localhost:8856/v1,API Key:local - 聊天界面选择
auto模型即可
Open WebUI 会自动发现 NadirClaw 的模型列表(auto、eco、premium 及各档模型)。
Continue 接入:编辑器内自动挂载
nadirclaw continue onboard # 自动写入 ~/.continue/config.json
nadirclaw serve
命令会把 "NadirClaw Auto" 插入 ~/.continue/config.json 的模型列表首位(自动备份原文件)。之后在 VS Code / JetBrains 的 Continue 模型下拉框中选择 NadirClaw Auto 就能开始路由。
OpenClaw 接入:注册为本地模型提供商
nadirclaw openclaw onboard # 将 NadirClaw 写入 OpenClaw 配置
nadirclaw serve
该命令会把 NadirClaw 作为 openai-completions 提供商写入 ~/.openclaw/openclaw.json,注册 nadirclaw/auto 模型(别名 nadir),并同步到每个 agent 的 models.json。若 OpenClaw 正在运行会自动重载配置,无需重启;也支持 SSE 流式输出与多模态内容。实现细节见 nadirclaw/cli.py。
路由档位:用 model 字段控制策略
无论哪个工具,把 model 字段设成下面任一值即可切换策略:
| 档位 | 策略 | 适用场景 |
|---|---|---|
auto |
智能路由(默认) | 综合最优 |
eco |
强制便宜模型 | 极限省钱 |
premium |
强制旗舰模型 | 质量优先 |
free |
使用免费/本地模型(如 Ollama) | 零成本 |
reasoning |
推理优化模型 | 复杂推理任务 |
验证接入是否成功,并查看实际省了多少钱 ✅
接入后先探测各模型可用性:
nadirclaw test # 逐档发送探测请求,报告延迟与回复
nadirclaw report # 按模型/按天的成本分布
nadirclaw savings # 相对基线模型的累计节省金额
report 输出会展示 Tier 分布(simple/complex 占比)、各模型请求数与 token 用量、延迟分布,配合 savings 命令就能量化看到路由带来的实际省钱效果——官方实测会话中通常可节省 50%–60% 成本。
常见问题速查
- 端口冲突? 用
NADIRCLAW_PORT环境变量改端口(默认 8856),工具端 Base URL 同步修改即可。 - 只想全本地、零成本? 设置
NADIRCLAW_SIMPLE_MODEL=ollama/llama3.1:8b、NADIRCLAW_COMPLEX_MODEL=ollama/qwen3:32b,无需任何 API Key。 - 模型挂了怎么办? 配置
NADIRCLAW_FALLBACK_CHAIN后备链,遇到 429/5xx/超时会按顺序自动切换,不丢请求。 - 分类不准? 用
nadirclaw classify "你的提示词"离线测试任意提示词会归到哪个档位。
把 5 个工具按清单逐一接入,同一个本地代理就能统一管理所有 AI 流量与账单——这就是 NadirClaw 的核心价值:你的密钥、你的模型、没有中间商。

