§04 模型随便换
DeerFlow 是模型中立的。这不是口号,是 config.yaml 里真能配出来的。
配置长什么样
模型在 config.yaml 里以列表形式声明,每一项是 name + use(LangChain 类路径)+ model + api_key:
models:
- name: gpt-4o
use: langchain_openai:ChatOpenAI
model: gpt-4o
api_key: $OPENAI_API_KEY
use 字段决定用哪个 LangChain 聊天模型类。DeerFlow 已经接好了多家:
| 提供方 | 示例模型 | 接入方式 |
|---|---|---|
| OpenAI | gpt-4o、gpt-5-responses(Responses API) |
langchain_openai:ChatOpenAI |
| OpenRouter | gemini-2.5-flash-preview(基址转发) |
转发基址 |
| vLLM 本地 | Qwen/Qwen3-32B |
VllmChatModel |
| Codex CLI | Codex 命令行后端 | CodexChatModel |
| Claude Code | Claude Code OAuth | ClaudeChatModel |
| MiniMax | 文本/生成模型 | 自带 patched 适配 |
官方推荐搭配 Doubao-Seed-2.0-Code、DeepSeek v3.2、Kimi 2.5 当主力模型。
两个注意点
- 环境变量占位符。上面
$OPENAI_API_KEY会从环境或.env读取,别写死明文。 - 多模型共存。你可以同时列五六个模型,运行时用
/model(终端)或界面切换。DeerFlow 默认就用第一个,但切模型是常态操作,不是改配置重启。
标叔的结论:DeerFlow 把「换模型」降到了改一行配置的事。但你真要稳定,建议先用官方推荐模型跑通,再试验本地 vLLM——本地模型的工具调用格式差异,是新手最常见的坑。
模型讲完,进入核心能力。下面九章,是 DeerFlow 真正的骨架。