OpenSwarm配置清单：5个API Key准备指南，让你的AI Agent团队火力全开
【免费下载链接】OpenSwarmClaude code for everything except coding项目地址: https://gitcode.com/gh_mirrors/open/OpenSwarm
OpenSwarm 是一款完全开源的多智能体系统，一句话指令就能在终端里产出演示文稿、研究报告、Word 文档、图片和视频。它由一个"总调度器"协调 8 个专职 AI Agent 协同干活。想让这支团队真正"火力全开"，关键一步是配置 API Key——本文是一份开箱即用的 OpenSwarm 配置清单，带你 5 分钟备齐 5 个核心密钥，并了解它们分别解锁哪些能力。
💡 一句话记忆：1 个"大脑"密钥必配 + 4 个"超能力"密钥按需加。
🧠 先搞懂：OpenSwarm 的 AI Agent 团队长什么样
OpenSwarm 不是"一个什么都会但样样不精"的大杂烩，而是把活儿分给一群专家：
| Agent | 擅长 | 主要依赖的密钥 |
|---|---|---|
| 🎯 Orchestrator 总调度 | 只路由、不直接干活，把请求分给对的专家 | 大脑密钥 |
| 🤝 Virtual Assistant 虚拟助理 | 写邮件、排日程、发消息，可接入 10,000+ 外部服务 | COMPOSIO_API_KEY |
| 🔬 Deep Research 深度研究 | 带引用、讲平衡的联网证据研究 | SEARCH_API_KEY |
| 📊 Data Analyst 数据分析师 | 结构化数据分析、图表、统计模型 | 大脑密钥 |
| 📽️ Slides Agent 演示文稿 | 生成精美 HTML 幻灯片并导出 PPTX | 大脑密钥 + GOOGLE_API_KEY |
| 📄 Docs Agent 文档 | 从大纲产出 Word / PDF | 大脑密钥 |
| 🎨 Image Agent 图片 | 用 Gemini / GPT 生成、编辑图片 | GOOGLE_API_KEY |
| 🎬 Video Agent 视频 | 用 Sora / Veo / Seedance 生成、剪辑视频 | GOOGLE_API_KEY / FAL_KEY |
团队的"大脑"和每个 Agent 的模型，都由 config.py 里的默认模型逻辑决定，整个 8 人阵容在 swarm.py 中一次性装配。
✅ 配置前准备：环境与一键安装
运行要求：Node.js 20+ 与 Python 3.12+，OpenSwarm 会自动创建或修复一个隔离的.venv。
最快启动方式（推荐新手）：
npx @vrsen/openswarm安装向导会自动引导你完成认证、依赖、配置三件事，其中"认证"这一步就是填 API Key 的入口。如果你更想自己掌控，也可以克隆源码本地跑：
git clone https://gitcode.com/gh_mirrors/open/OpenSwarm cd OpenSwarm python swarm.py⚙️ 小提示：如果不需要遥测，可设置
ENABLE_TELEMETRY=0（或--no-telemetry）关闭。
🔑 核心清单：5 个 API Key 一次看全
下面就是本次的"配置清单"。前两个是"二选一必配"的大脑，后四个是"按需点亮"的超能力。完整定义可在 README.md 的 API Keys & Setup 一节对照阅读。
1️⃣ OPENAI_API_KEY：默认大脑 + Sora 视频（二选一必配）
这是最常用的一把钥匙，一举两得：
- 🧠 驱动默认的 GPT 系列模型，作为多数 Agent 的大脑；
- 🎬 解锁 Sora 视频生成（
sora-2/sora-2-pro）。
注意：只有 OpenAI 的"媒体类"端点（图片、视频）依赖它，浏览器式登录鉴权走不通这些端点——判断逻辑见 shared_tools/model_availability.py。
2️⃣ ANTHROPIC_API_KEY：Claude 模型备选大脑（二选一必配）
如果你更偏爱 Claude，就用它替代上一把作为主脑。OpenSwarm 通过provider/model形式的字符串（如anthropic/claude-...）自动走 LiteLLM 路由，规则在 config.py 里，无需额外配置。
📌 两者配一个即可启动。配哪个，就看你手里哪个账号的额度更大。
3️⃣ COMPOSIO_API_KEY：解锁 10,000+ 外部集成（强烈建议）
这一个 Key 能让"虚拟助理"真正帮你打通 Gmail、Slack、GitHub、HubSpot、Notion 等上千个服务——发邮件、查日历、读消息一条龙。它属于 openswarm.config.mjs 里登记的官方 Addon，配合COMPOSIO_USER_ID一起生效。
💬 场景：让它"把昨天没回的 Slack 消息整理成待办并发到日历"，没有它就只能干瞪眼。
4️⃣ GOOGLE_API_KEY：Gemini 图片 + Veo 视频（做图做片必配）
一把钥匙点亮"多模态创作"：
- 🎨图片：Gemini 2.5 Flash Image / Gemini 3 Pro Image；
- 🎬视频：Veo 3.1（
veo-3.1-generate-preview/veo-3.1-fast-generate-preview）。
是否可用由 shared_tools/model_availability.py 实时检测，缺失时会给出友好提示而非直接报错。
5️⃣ SEARCH_API_KEY：给研究 Agent 装上"联网搜索"
Deep Research Agent 要给出"带引用、讲平衡"的结论，离不开真实检索。加上它，Agent 才能现查资料、引用来源，而不是靠"记忆"硬编。对应的搜索工具见 virtual_assistant/tools/ScholarSearch.py 与 Web Search Addon（定义于 openswarm.config.mjs）。
💾 密钥存在哪？——/addons 一键管理
这些 Key 不会被写死在代码里，而是统一存放在你的状态根目录下的.env：
- 🐧 Linux / macOS：
~/.openswarm/.env - 🪟 Windows：
%APPDATA%/OpenSwarm/.env
状态根路径的确定逻辑在 run_utils.py，启动时会用load_dotenv读入（见 swarm.py）。
最省事的管理方式：在 OpenSwarm 终端里输入/addons，即可图形化地添加、查看、增删每一个 Addon 密钥。
一个典型.env长这样：
OPENAI_API_KEY=sk-xxxxxx COMPOSIO_API_KEY=cp-xxxxxx COMPOSIO_USER_ID=你的用户ID GOOGLE_API_KEY=AIzaxxxxxx SEARCH_API_KEY=你的搜索密钥🧩 进阶：按需再加的"锦上添花"密钥
除了 5 个核心，OpenSwarm 还预留了更多 Addon（完整清单见 run_utils.py），用多少补多少：
- 🎥FAL_KEY：更高级的视频剪辑、特效与 Seedance 视频、背景移除（model_availability.py）。
- 🖼️图库类：
PEXELS_API_KEY/PIXABAY_API_KEY/UNSPLASH_ACCESS_KEY，让 Slides / Image Agent 能直接调用高质量免版权素材图。
🛠️ 设计哲学：缺 Key 时工具会优雅降级——不崩溃，而是明确告诉你"该补哪个 Key"，见 shared_tools/model_availability.py。
🚀 验证清单：确认你的团队已"火力全开"
启动 OpenSwarm 时，会打印一份可选集成清单，用 ✓ / ✗ 标出每个能力是否就绪（run_utils.py）。对照下面自查一遍：
- 已配
OPENAI_API_KEY或ANTHROPIC_API_KEY（至少一个）→ 团队大脑在线 - 已配
COMPOSIO_API_KEY→ 外部服务集成可用 - 已配
GOOGLE_API_KEY→ Gemini 图片 + Veo 视频可用 - 已配
SEARCH_API_KEY→ 深度研究联网可用 - （可选）
FAL_KEY/ 图库 Key → 高级视频与免版权素材
全部打勾后，直接在终端丢一句需求试试，比如"给 OpenSwarm 做一份完整的投资人路演"，看你的 8 人 Agent 团队如何各司其职、自动交接、交付成品。
🎯 记住这张清单，你的 OpenSwarm 就从"能跑"升级到"火力全开"了。想要更进一步？shared_tools/、image_generation_agent/、video_generation_agent/ 等目录里的工具源码，能帮你读懂每个能力背后的实现细节。
【免费下载链接】OpenSwarmClaude code for everything except coding项目地址: https://gitcode.com/gh_mirrors/open/OpenSwarm
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
