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，所有请求经过它时会自动执行三步：

1. Route（路由）：约 10ms 的嵌入式分类器判断提示词难度，简单请求发给便宜模型；
2. Verify（验证）：对廉价模型的回复做质量检查（拒绝、截断、JSON 格式失败等）；
3. 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 个工具按清单逐个接入即可。

五大工具接入清单速览 📋

💡onboard命令会在写入前自动备份原有配置（生成.backup-时间戳文件），可随时回滚。

Cursor 接入：设置里填 3 个值

1. 启动路由：nadirclaw serve
2. 运行nadirclaw cursor onboard查看指引
3. Cursor 中进入Settings → Models，填写：
   • API Key：local
   • Base URL：http://localhost:8856/v1
   • Model name：auto

保存后选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 接入：管理后台添加连接

1. 运行nadirclaw openwebui onboard查看步骤
2. Open WebUI 中进入Admin Settings → Connections → OpenAI → Add Connection
3. 填写URL：http://localhost:8856/v1，API Key：local
4. 聊天界面选择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 字段设成下面任一值即可切换策略：

验证接入是否成功，并查看实际省了多少钱 ✅

接入后先探测各模型可用性：

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 的核心价值：你的密钥、你的模型、没有中间商。