OpenSwarm模型配置详解DEFAULT_MODEL与LiteLLM如何让你自由切换GPT和Claude【免费下载链接】OpenSwarmClaude code for everything except coding项目地址: https://gitcode.com/gh_mirrors/open/OpenSwarm如果你正在寻找OpenSwarm 模型配置的方法这篇文章正是为你准备的。OpenSwarm 是一个开源的多智能体 AI 团队Claude Code for everything except coding8 个专业智能体协作完成幻灯片、深度研究、文档、图片与视频生成。它的核心设计是所有智能体共用一个DEFAULT_MODEL环境变量配合 LiteLLM 自动路由你可以一行配置在 GPT 和 Claude 之间自由切换。 为什么 OpenSwarm 的模型切换如此简单传统做法是每个智能体各自硬编码模型改一个模型要改 N 处代码。OpenSwarm 的做法完全不同——所有智能体绝不硬编码模型而是启动时统一读取.env中的DEFAULT_MODEL。这一约定写在项目的定制指南 AGENTS.md 中Models are configured viaDEFAULT_MODELin.env— never hardcoded也就是说无论 Orchestrator协调者、Slides Agent、Deep Research 还是 Video Agent全部智能体的模型定义都调用同一个函数模型选择集中管理。整个智能体网络的组装过程见 swarm.py。⚙️ 核心原理一个环境变量管住 8 个智能体模型配置的全部逻辑集中在 config.py 里只有不到 40 行def get_default_model(fallback: str gpt-5.4): model os.getenv(DEFAULT_MODEL, fallback) return _resolve(model)工作流程非常简单启动时从环境变量读取DEFAULT_MODEL未设置则回退到gpt-5.4判断模型字符串里有没有斜杠/没有斜杠 → 按 OpenAI 原生模型处理有斜杠 → 交给 LiteLLM 路由每个智能体在定义时都直接引用它例如from config import get_default_model # 所有智能体统一写法 modelget_default_model()涉及 orchestrator/orchestrator.py、slides_agent/slides_agent.py、deep_research/deep_research.py、virtual_assistant/virtual_assistant.py 等全部 8 个智能体文件。 LiteLLM 如何自动路由你的模型关键就藏在命名约定里这是 OpenSwarm 模型配置最巧妙的部分写法是否含/路由方式gpt-5.4❌OpenAI 原生直连o3❌OpenAI 原生直连litellm/claude-sonnet-4-6✅LiteLLM → Anthropiclitellm/gemini/gemini-3-flash✅LiteLLM → Google判断逻辑在 config.py 的is_openai_provider()函数中OpenAI model IDs never contain a slash (e.g. gpt-5.4, o3). Any provider/model string is treated as a LiteLLM-routed model.而实际的路由发生在 _resolve() 函数中只要模型名带斜杠就会自动剥掉litellm/前缀构造一个LitellmModel对象来自底层框架 agency-swarm无需手写任何客户端代码。一句话总结写gpt-5.4就走 OpenAI写litellm/...就走 LiteLLM框架自己识别。️ 三步切换从 GPT 到 Claude 的最快配置方法切换模型只需要改项目状态目录下的.env文件模板见 .env.example1️⃣ 保持原来的 OpenAI 配置OPENAI_API_KEYsk-xxx DEFAULT_MODELgpt-5.42️⃣ 切换为 Claude 只需两行ANTHROPIC_API_KEYsk-ant-xxx DEFAULT_MODELlitellm/claude-sonnet-4-63️⃣ 或者切到 Google GeminiGOOGLE_API_KEYxxx DEFAULT_MODELlitellm/gemini/gemini-3-flash就这么简单——没有代码改动重启即可全部 8 个智能体同步生效。 智能体的模型回退逻辑进阶部分高级工具如 Slides Agent 的幻灯片 HTML 编写器有多级模型优先级见 slides_agent/tools/ModifySlide.py存在ANTHROPIC_API_KEY→ 优先用 Claude Sonnet 4.6DEFAULT_MODEL为非 OpenAI 模型 → 走 LiteLLM 路由复用调用方智能体的 OpenAI 客户端支持 Codex 浏览器认证最终回退到 SDK 默认客户端这种设计保证了无论你配的是哪家模型工具链都能优雅降级并且当缺少某个厂商的 Key 时shared_tools/model_availability.py 会清晰告诉你哪些模型可用、缺哪个 Key而不是直接报错。 常见配置速查表需求.env配置说明OpenAI 默认DEFAULT_MODELgpt-5.4未配置时的内置回退值主力 ClaudeDEFAULT_MODELlitellm/claude-sonnet-4-6需ANTHROPIC_API_KEY主力 GeminiDEFAULT_MODELlitellm/gemini/gemini-3-flash需GOOGLE_API_KEY混合场景两个 API Key 都填智能体按优先级自动选择✅ 小结OpenSwarm 的模型配置体现了多智能体系统的好实践单一入口DEFAULT_MODEL一个变量控制所有智能体零代码路由/有无自动区分 OpenAI 直连与 LiteLLM 路由优雅降级缺少 Key 时给出明确提示而非崩溃永不硬编码改配置即换模型Fork 后自定义 Swarm 同样受益想深入了解智能体结构可以阅读 AGENTS.md想查看各智能体如何使用模型入口都在 config.py 这一个文件里。【免费下载链接】OpenSwarmClaude code for everything except coding项目地址: https://gitcode.com/gh_mirrors/open/OpenSwarm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考