CAMEL：研究 Agent 扩展定律的开源多 Agent 协作框架｜安装与使用全指南

仓库：https://github.com/camel-ai/camel 官方站点：https://www.camel-ai.org/ 许可证：Apache-2.0（以仓库 LICENSE 为准） 运行形态：Python 库（pip install 'camel-ai[web_tools]'），无 Web 端口

1. 项目简介

CAMEL 是一个专注研究 Agent 扩展定律（scaling laws of agents）的开源社区项目，由 100+ 研究者组成。它实现并支持各类 Agent、任务、prompt、模型与模拟环境，核心是多 Agent 协作。设计原则是可演化（Evolvability）、可扩展（Scalability，支持百万级 Agent 系统）、有状态（Statefulness，Agent 带状态记忆）、Code-as-Prompt（代码即 prompt）。

1.1 核心信息一览

1.2 适用场景

• 研究多 Agent 协作、可演化、可扩展系统；
• 做数据生成、任务自动化、世界模拟；
• 需要带记忆的多步 Agent 交互实验。

1.3 能力边界（官方口径）

• 定位是研究社区与框架，不自带托管 UI；
• 模型 Provider 凭据需自备；
• 面向研究场景，生产方案需自行封装。

2. 功能特性

• 可演化：通过生成数据与环境交互持续进化，可由可验证奖励 RL 或监督学习驱动；
• 可扩展：设计支持百万级 Agent 系统的协调、通信与资源管理；
• 有状态：Agent 维持状态记忆，做多步环境交互；
• Code-as-Prompt：代码与注释本身即 prompt；
• 三大用途：数据生成、任务自动化、世界模拟；
• 丰富 Cookbook：基础概念、高级特性、训练与数据生成、多 Agent 系统、数据处理。

3. 官方界面预览

上图为官方 README banner（README 官方素材）。

4. 官方跳转链接汇总

• 仓库主页：https://github.com/camel-ai/camel
• 官方站点：https://www.camel-ai.org/
• 示例：https://github.com/camel-ai/camel/tree/HEAD/examples
• 论文：https://arxiv.org/abs/2303.17760
• Discord：https://discord.camel-ai.org/
• 文档：README 顶部 docs 徽章链接

5. 前置要求与服务器配置

• Python 环境；
• OpenAI API Key（或对应 Provider）；
• 无端口、无数据库。

6. 方式一：pip 安装（推荐）

pip install 'camel-ai[web_tools]'

配置密钥：

export OPENAI_API_KEY='your_openai_api_key'
# 或用 .env 文件

最小 ChatAgent + DuckDuckGo 搜索示例（结构以官方 Starting with ChatAgent 为例）：

from camel.agents import ChatAgent
# 其余导入与用法见官方 examples 仓库

7. 方式二：源码运行

git clone https://github.com/camel-ai/camel.git
cd camel
# 开发安装见仓库 CONTRIBUTING.md

8. 配置项说明

9. 常用运维命令

# 安装
pip install 'camel-ai[web_tools]'

# 升级
pip install -U 'camel-ai[web_tools]'

# 密钥
export OPENAI_API_KEY=...

10. 常见故障排查

• 模型 401：检查 OPENAI_API_KEY 或 .env；
• 工具缺失：按示例装对应 extras（如 [web_tools]）；
• 想跑示例：参考 examples 目录；
• 依赖冲突：建议虚拟环境隔离。

11. 风险与合规说明

• Apache-2.0 许可；
• 定位为研究框架，生产使用需自行评估与封装；
• 模型调用费用由对应 Provider 账号承担；
• 本文为社区部署笔记，命令以官方 README 最新版本为准。