Dr. Claw 多模型后端配置教程:Claude Code、Gemini CLI、Codex、OpenRouter 一键接入(新手完整指南)
Dr. Claw 多模型后端配置教程:Claude Code、Gemini CLI、Codex、OpenRouter 一键接入(新手完整指南)
Dr. Claw 是一个开源的多模型 AI 研究工作台(AI Lab / 研究 IDE),让你在一套界面里同时接入 Claude Code、Gemini CLI、Codex 和 OpenRouter 四大模型后端。本教程将带你从零完成 Dr. Claw 多模型后端配置:3 步启动应用、逐个打通每个后端、并在聊天界面自由切换模型——无需订阅、跑在你自己的机器上,数据与 GPU 全部由你掌控。
为什么推荐 Dr. Claw 的多模型后端
很多 AI 工具只能绑定单一模型厂商,而 Dr. Claw 把 Claude Code、Gemini CLI、Codex、OpenRouter 都做成了一等公民:
- 🧠 四大执行引擎自由切换:不同任务用不同模型,界面随时换
- 🔑 一个 Key 解锁数百模型:通过 OpenRouter 接入 GPT、Claude、Gemini、DeepSeek、Qwen、Kimi 等
- 🛠️ 与工具能力对齐:无论选哪个后端,都支持文件读写、Shell、搜索、网页抓取等完整工具调用
- 📊 覆盖科研全流程:文献调研 → 想法生成 → 实验 → 论文写作 → 成果展示
后端的安装检测与登录状态都集中在 Settings → 智能体 页面管理(见 src/components/Settings.jsx),每个后端独立显示"已登录 / 未安装 / 已断开"状态,配置互不干扰。
快速上手:3 步启动 Dr. Claw
前置条件:Node.js v20 或更高(推荐 v22 LTS)。
第 1 步:零安装启动(推荐)
npx dr-claw
或者全局安装:
npm install -g dr-claw
dr-claw
第 2 步:打开浏览器访问 http://localhost:3001,注册并登录你的账户。
第 3 步:在侧边栏点击齿轮图标打开 Settings,进入 智能体 页签,开始配置下文介绍的后端。
💡 也可以从源码运行(便于二次开发):
git clone https://gitcode.com/gh_mirrors/dr/dr-claw后执行npm install && npm run dev,完整步骤见 README.zh-CN.md。
逐个接入 4 大模型后端
后端一:接入 Claude Code
| 步骤 | 操作 |
|---|---|
| 1. 安装 CLI | npm install -g @anthropic-ai/claude-code |
| 2. 登录 | 终端执行 claude,按提示完成 OAuth 授权 |
| 3. 界面确认 | Settings → 智能体 → Claude 卡片显示"已登录" |
如果 claude 不在系统 PATH 中,可在 .env 里指定 CLAUDE_CLI_PATH 指向二进制位置。
后端二:接入 Gemini CLI
| 步骤 | 操作 |
|---|---|
| 1. 安装 CLI | npm install -g @google/gemini-cli |
| 2. 登录 | 终端执行 gemini 完成 Google 登录,或设置 export GOOGLE_API_KEY=... |
| 3. 界面确认 | Settings → 智能体 → Gemini 卡片显示"已登录" |
路径异常时可用 GEMINI_CLI_PATH 覆盖默认命令名,全部变量说明见 docs/configuration.zh-CN.md。
后端三:接入 Codex
| 步骤 | 操作 |
|---|---|
| 1. 安装 CLI | npm install -g @openai/codex |
| 2. 登录 | codex login,或 export OPENAI_API_KEY=... |
| 3. 界面确认 | Settings → 智能体 → Codex 卡片显示"已登录" |
⚠️ 使用 Codex 后端时,
.env中的OPENAI_API_KEY是应用侧识别密钥的关键变量;CLI 不在默认PATH时用CODEX_CLI_PATH指定。
后端四:OpenRouter 一个 Key 接入数百模型
OpenRouter 是唯一的"免 CLI 安装"后端——无需任何本地工具,一个 API 密钥即可路由到数百个模型。配置密钥有三种等价方式:
- 界面:Settings → OpenRouter,粘贴你的 Key
- 环境变量:
export OPENROUTER_API_KEY=sk-or-... .env文件:写入OPENROUTER_API_KEY=sk-or-...
设置默认模型:
OPENROUTER_MODEL=moonshotai/kimi-k2.5
不设置时默认为 anthropic/claude-sonnet-4.6。OpenRouter 还支持直接输入任意模型 slug(如 deepseek/deepseek-r1、qwen/qwen3-235b-a22b),内置模型清单定义在 shared/modelConstants.js,相关路由实现在 server/openrouter.js。
在 Chat 中选择与切换模型
配置完成后,进入任意项目的 Chat 页签:
- 在输入框上方的 Choose Your AI Assistant(选择你的 AI 助手)区域,点击目标后端(Claude Code / Gemini / Codex / OpenRouter)
- 在下拉框中选择具体模型——OpenRouter 会实时拉取完整模型列表,也支持手动输入自定义模型名
- 开始对话即可,界面上会显示"Ready to use ... with {{model}}"提示
切换后端不会影响项目数据,只更换"执行引擎"。此外 Research Lab 的任务执行也可以从 CLI 选择器中选择 Claude Code、Gemini CLI 或 Codex 作为执行后端;Auto Research 无人值守研究同样支持这四类引擎(见 README.zh-CN.md 的 Usage Guide 章节)。
常见问题排查:配置不生效怎么办
- 🔍 状态显示"未安装 CLI":确认终端能直接运行
claude/gemini/codex;不行就用*_CLI_PATH变量指定完整路径 - 🔄 改了
.env没生效:系统环境变量优先于.env,检查是否有同名变量覆盖;改完务必重启应用(加载逻辑见 server/load-env.js) - 💬 Shell 标签页报
posix_spawnp failed:执行npm rebuild node-pty --build-from-source修复原生模块 - ⚖️ 权限相关:各后端的权限(允许/禁止的工具、跳过权限提示)在 Settings → 权限 中按提供方独立配置,放宽前请阅读说明
- 🧾 更多问题:完整"问题 → 原因 → 解决方案"清单见 docs/faq.zh-CN.md
进阶:终端直接跑 OpenRouter 模型
不想开浏览器?Dr. Claw 内置了纯终端的 Agent 会话命令,任意 OpenRouter 模型均可用:
export OPENROUTER_API_KEY=sk-or-...
node server/cli.js chat --model moonshotai/kimi-k2.5
该命令提供与 UI 相同的工具调用能力(文件 I/O、Shell、Grep、Glob、网页搜索/抓取),适合轻量工作流。
相关文件与资料导航
| 内容 | 路径 |
|---|---|
| 中文总文档与快速上手 | README.zh-CN.md |
完整环境变量参考(.env) |
docs/configuration.zh-CN.md |
| 故障排查 FAQ | docs/faq.zh-CN.md |
| 全量模型定义与默认值 | shared/modelConstants.js |
| 后端登录与状态检测界面 | src/components/Settings.jsx |
| OpenRouter 后端路由 | server/openrouter.js |
| 终端聊天 CLI | server/cli.js |
小结
- ✅ 先
npx dr-claw启动,再进 Settings → 智能体 逐个验证后端状态 - ✅ Claude Code / Gemini CLI / Codex 走"安装 CLI + 登录",OpenRouter 只需一个 API Key
- ✅ Chat 页签的 Choose Your AI Assistant 可随时切换后端与模型
- ✅ 出问题先查 docs/faq.zh-CN.md 和 docs/configuration.zh-CN.md
按以上步骤走完,你就拥有了一个"模型随心换"的本地 AI 研究工作台——把选型时间省下来,专注研究本身吧 🚀



