crewAI

让多个 AI 角色组队协作，搞定复杂任务！

crewAI 是一个用于编排角色扮演、自主 AI 智能体的 Python 框架。它通过促进协作智能，让多个具有不同角色和目标的 AI 智能体协同工作，共同解决复杂任务。该框架解决了单个大语言模型在处理复杂工作流时能力受限的问题，提供了一种结构化的方式来定义智能体、分配任务、管理工具，并控制执行流程。其核心能力包括：基于角色的智能体定义、任务分解与分配、动态任务执行、内置工具集成、以及流程管理（如顺序执行和层级管理）。crewAI 的设计理念是模拟真实团队合作，让每个智能体扮演特定角色（如研究员、分析师、写手），通过协作完成从市场调研到内容生成等端到端任务。它提供了简洁的 API 和丰富的配置选项，使开发者能够快速构建复杂的多智能体应用，而无需深入底层的大模型交互细节。

开源 freemium 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 58916

维护状态活跃

是否开源是

定价模式 freemium

项目数据

分类智能体

开发团队crewAIInc

所属国家

官网地址https://crewai.com

GitHubhttps://github.com/crewAIInc/crewAI

定价模式freemium

价格说明开源框架免费，提供托管平台CrewAI Studio，有免费额度，付费解锁更多功能。

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agents,ai,ai-agents,aiagentframework,llms

GitHub 星标★ 58916

30天Star增速

HF 下载量

上线时间2023-10-27 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：命令行工具 8 步

环境要求

Python >=3.10 且 <3.14
已安装 uv 包管理器
Windows 用户如遇编译错误需安装 Visual Studio Build Tools（Desktop development with C++）
准备模型提供商的 API Key；若使用网页搜索还需 Serper.dev API Key

安装与启动步骤

1检查 Python 版本

CrewAI 要求 Python >=3.10 且 <3.14，先确认本机版本是否满足。版本不符请先升级或切换 Python。
```
python3 --version
```
2安装 uv（macOS/Linux）

CrewAI 使用 uv 管理依赖与包，官方推荐脚本安装。系统无 curl 时可改用 wget 命令。
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```
3安装 uv（Windows）

Windows 用户用 PowerShell 执行官方安装脚本。若失败可参考 UV 官方安装指南排查。
```
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```
4安装 CrewAI CLI

用 uv 安装全局 crewai 命令行工具。若提示 PATH 警告，再执行 uv tool update-shell 修复。
```
uv tool install crewai
```
5验证安装

列出已安装的 uv 工具，确认 crewai 已出现及版本号，例如 crewai v0.102.0。
```
uv tool list
```
6创建项目

用 crewai create crew 命令生成新项目脚手架，把换成你自己的项目名。
```
crewai create crew my_project
```
7配置 .env

在项目 .env 中填写模型提供商 API Key；若使用网页搜索，再填 SERPER_API_KEY=YOUR_KEY_HERE。
8安装依赖并运行

在项目目录下先 crewai install 安装依赖，再 crewai run 启动。需要额外包时用 uv add 添加。
```
crewai install
crewai run
```

关键配置

配置项	必填	说明	示例
`模型提供商 API Key`	是	调用大模型必需，具体变量名见官方 LLM setup 文档	`sk-xxxxxxxx`
`SERPER_API_KEY`	否	使用网页搜索工具时必需，从 Serper.dev 获取	`YOUR_KEY_HERE`

如何确认成功

uv tool list 能看到 crewai 及版本号；crewai run 后控制台有输出，且项目根目录生成 output/report.md。

常见问题

Q：如何安装 CrewAI？

A：先用 UV 安装 CLI：uv tool install crewai；再执行 crewai create crew 创建项目，随后 crewai install 安装依赖、crewai run 启动。

Q：Windows 上安装报 chroma-hnswlib==0.7.6 编译错误怎么办？

A：错误提示 fatal error C1083: Cannot open include file: 'float.h' 时，请安装 Visual Studio Build Tools 并勾选“Desktop development with C++”。

Q：出现 PATH 警告怎么办？

A：执行 uv tool update-shell 刷新 shell 配置即可。

Q：如何升级 CrewAI？

A：升级全局 CLI 用 uv tool install crewai --upgrade；项目虚拟环境内的 crewai 版本需按官方升级指南单独处理。

Q：CrewAI 支持云端和本地部署吗？

A：CrewAI AMP 同时支持云端与本地（on-premise）部署，可满足企业的安全与合规要求。

注意事项

运行前务必在 .env 中配置模型提供商 API Key，否则无法执行任务
Python 版本必须满足 >=3.10 且 <3.14
uv tool install crewai --upgrade 只升级全局 CLI，不影响项目内的 crewai 版本
层级（hierarchical）流程会自动指派经理来协调任务规划与执行，可按需选择

核心亮点

角色扮演式智能体设计，直观模拟团队协作，易于理解和使用
支持动态任务分配和流程编排，可处理复杂工作流
与 LangChain 工具生态兼容，扩展性强

不足之处

智能体间通信和协调机制相对简单，复杂场景下可能效率不高
文档/社区待观察

适用场景

自动化市场调研与竞品分析报告生成
多步骤内容创作（如博客、视频脚本）流水线
企业内部流程自动化（如客户支持工单分类与回复）

替代项目

AutoGen、LangGraph、MetaGPT

项目介绍

crewAI 是智能体领域的开源项目，由 crewAIInc 开发，2023 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（58,916）位列前 1%，在智能体分类的 2,499 个项目里位列前 1%。

近 44 天，它的 GitHub 星标从 56,858 增加到 58,916，净增 2,058。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。开源框架免费，提供托管平台CrewAI Studio，有免费额度，付费解锁更多功能。从国内网络环境看，访问稳定性一般，建议自备网络条件。

它主要面向的使用场景是：自动化市场调研与竞品分析报告生成。同类可对比的替代方案包括 AutoGen、LangGraph、MetaGPT。

上一篇：claude-code-best-practice

下一篇：goose