ChatDev 2.0 (DevAll)：零代码多智能体平台的设计与使用

ChatDev 2.0 真正解决的问题不是"又一个多智能体框架"——它把智能体协作从代码层抽到配置层，让非开发者也能用 YAML 定义工作流、用 Web 控制台拖拽编排，同时保留 Python SDK 给需要批量和定制的场景。本文从平台设计出发，拆解它的编排模型、工作流机制和扩展方式，最后给出什么时候该用它、什么时候不该用的判断。

学习目标

这篇文章回答以下几个问题：

• ChatDev 2.0 和 1.0 在设计思路上有什么根本区别？
• 一个典型工作流从 YAML 定义到执行完成，中间经过哪些环节？
• 什么场景适合用 Web 控制台，什么场景更适合用 Python SDK？
• 如果你想在 ChatDev 里加自己的工具或节点，需要改哪些地方？

系统地图

ChatDev 2.0 的几块主要拼图：

思路是：配置定义"做什么"，运行时负责"怎么做"。用户写 YAML 描述智能体角色和工作流拓扑，运行时拿到配置后实例化智能体、注入工具、按拓扑调度执行——整个过程不需要用户写任何编排代码。

§2 项目背景

2.1 ChatDev 1.0 → 2.0：从模拟公司到通用平台

ChatDev 1.0 的设计思路是模拟一家软件公司：CEO 拆需求、CTO 做技术决策、程序员写代码、测试跑用例——它用多智能体对话复现了软件开发的完整流程。

ChatDev 2.0 (DevAll) 把"多智能体协作"抽象成了一套通用编排框架。它不再预设"软件公司"这个场景，而是让你用 YAML 定义任意角色和交互拓扑，跑数据可视化、3D 生成、游戏开发、深度研究等各种工作流。

2.2 项目概况

ChatDev 2.0 由 OpenBMB 团队开发，Apache-2.0 协议开源。GitHub 仓库 目前 32.4k Stars、4k Forks，67 位贡献者参与了 163 次提交，最新版本 v2.2.0（2026 年 3 月）。代码以 Python 为主（68.2%），前端用 Vue 3（28.7%），少量 JavaScript、CSS 和 Docker 配置。官网：chatdev.top。

ChatDev 1.0 代码仍保留在 chatdev1.0 分支，论文见 arXiv:2307.07924。

ChatDev 2.0 (DevAll) is a Zero-Code Multi-Agent Platform for “Developing Everything”. It empowers users to rapidly build and execute customized multi-agent systems through simple configuration. No coding is required — users can define agents, workflows, and tasks to orchestrate complex scenarios such as data visualization, 3D generation, and deep research.

§3 核心机制

3.1 零代码编排：YAML 定义一切

ChatDev 2.0 的编排模型分为三层：

模板层 (yaml_template/)：定义可复用的工作流骨架——有哪些智能体、每个智能体挂什么工具、节点之间怎么连接。

实例层 (yaml_instance/)：基于模板填入具体参数——任务 prompt、附件路径、变量值。

运行时 (runtime/)：解析实例配置，实例化智能体，按拓扑顺序调度执行。执行过程中产生的消息、中间文件、状态变化都通过 Web 控制台或 SDK 暴露出来。

这种"模板 + 实例"分离的设计带来一个直接好处：团队可以维护一套工作流模板库，不同任务只需创建新的实例文件，不改模板逻辑。人在环（Human-in-the-Loop）反馈机制也嵌入在执行链路里——你可以在工作流执行中途输入修正指令，运行时会把反馈注入到后续节点的上下文中。

3.2 Web 控制台

Web 控制台（Vue 3）提供三个核心界面，本质上是对配置文件和运行时的图形化封装：

• Tutorial：内嵌的分步指南，覆盖从创建第一个工作流到调试执行的完整流程。
• Workflow：可视化画布，拖拽节点、配置参数、定义节点间的上下文传递。
• Launch：启动工作流后，实时查看每个节点的执行日志和中间产物。

你在画布上的操作最终会落到 YAML 实例文件里，启动按钮触发的是 runtime/sdk 的执行入口。

3.3 Python SDK

当你需要批处理、CI/CD 集成或程序化控制时，Python SDK 比 Web 控制台更合适：

from runtime.sdk import run_workflow

result = run_workflow(
    yaml_file="yaml_instance/demo.yaml",
    task_prompt="Summarize the attached document in one sentence.",
    attachments=["/path/to/document.pdf"],
    variables={"API_KEY": "sk-xxxx"}
)

if result.final_message:
    print(f"Output: {result.final_message.text_content()}")

run_workflow 返回的 result 对象包含最终消息、中间产物路径和执行状态。SDK 也发布到了 PyPI：pip install chatdev。

3.4 OpenClaw 集成

OpenClaw 可以通过两种方式调用 ChatDev：

• 调用已有工作流：把 ChatDev 里配好的智能体团队当作一个可远程调用的能力单元。
• 动态创建新团队：让 OpenClaw 在运行时根据任务描述自动生成 ChatDev 工作流配置并执行。

clawdhub install chatdev

典型场景：用 OpenClaw 定时触发 ChatDev 工作流——比如每天早上自动收集趋势信息，生成内容并发布。

3.5 Docker 部署

docker compose up --build

启动后后端在 http://localhost:6400，前端在 http://localhost:5173。Docker Compose 配置了自动重启和本地文件挂载，改代码后容器内同步生效。

§4 工作流详解

4.1 一个任务如何流过系统

在罗列工作流模板之前，先看一个完整案例——用"数据可视化"工作流把一份 CSV 变成图表，理解 ChatDev 的调度链路：

1. 定义模板：data_visualization_enhanced.yaml 定义了三个智能体节点——数据读取、图表生成、质量检查——以及它们之间的消息流向。
2. 创建实例：用户在 Launch 界面选择该模板，上传 transactions.csv，输入 prompt：“Create 4–6 high quality PNG charts for my large real-estate transactions dataset.”
3. 运行时调度：runtime/ 解析 YAML 实例，创建三个智能体实例，注入配置中声明的工具（如 pandas、matplotlib），按拓扑顺序执行：
   • 节点 1（数据读取）：加载 CSV，输出数据摘要。
   • 节点 2（图表生成）：接收摘要和原始数据，生成 PNG 图表。
   • 节点 3（质量检查）：检查图表可读性、数据映射是否正确，通过后输出最终产物。
4. 产物交付：PNG 文件写入工作目录，Web 控制台显示每个节点的日志和中间产物，SDK 调用者通过 result.final_message 拿到路径。

这个流程里，用户没有写一行 Python 代码——所有逻辑由 YAML 模板和运行时驱动。

4.2 内置工作流一览

所有可运行的工作流配置在 yaml_instance/ 目录下，分为 Demo（demo_*.yaml）和完整实现（直接命名的文件）。

4.3 各工作流示例 Prompt

§5 部署与配置

5.1 环境要求

5.2 安装

uv sync                           # Python 后端依赖
cd frontend && npm install        # Vue 3 前端依赖

5.3 配置

cp .env.example .env

在 .env 中配置 API_KEY 和 BASE_URL。支持任何兼容 OpenAI API 格式的 LLM 提供商。YAML 配置文件中用 ${VAR} 引用这些变量（如 ${API_KEY}）。

5.4 启动

make dev    # 同时启动前后端

访问 http://localhost:5173。

手动启动（适用于需要自定义端口或调试的场景）：

其他命令：

§6 使用指南

6.1 Web 控制台

1. 在 Launch 标签页选择工作流。
2. 上传必要附件（如数据分析的 .csv 文件）。
3. 输入任务描述（如 “Visualize the sales trends”）。
4. 启动并监控执行过程，中间产物实时可见。

6.2 Python SDK

from runtime.sdk import run_workflow

result = run_workflow(
    yaml_file="yaml_instance/demo.yaml",
    task_prompt="Your task prompt here",
    attachments=["/path/to/file.pdf"],
    variables={"API_KEY": "your-api-key"}
)

if result.final_message:
    print(result.final_message.text_content())

6.3 OpenClaw 集成

clawdhub install chatdev

安装后在 OpenClaw 中即可调用 ChatDev 工作流。典型场景包括自动化信息收集与发布、多智能体场景模拟。

§7 技术架构

§8 开发扩展

8.1 添加新节点

在 server/ 中定义新的节点类型，在 workflow/ 中实现编排逻辑。

8.2 添加新工具

在 functions/ 目录添加自定义 Python 工具：

# functions/my_custom_tool.py
def my_custom_tool(param1: str, param2: int) -> str:
    """自定义工具描述"""
    # 实现逻辑
    return result

8.3 添加新工作流

在 yaml_template/ 创建新的 YAML 工作流定义文件。

8.4 自定义提供商

在 runtime/ 中添加新的 LLM 提供商支持。

§9 推荐做法

工作流设计：把复杂任务拆成多个可组合的小工作流，不要塞进一个大 YAML。任务描述写清楚输入、输出和约束——减少智能体误判。定期检查中间产物，大部分问题在中间节点就已经暴露。人在环反馈不是锦上添花：对生成类任务（图表、3D、视频），中间纠偏可以大幅减少无效重跑。

性能：生产环境去掉 --reload 标志。批量任务走 Python SDK，比反复操作 Web 控制台高效。Docker 部署时设合理的 CPU/内存限制。

安全：API 密钥只放 .env，用 ${VAR} 在 YAML 中引用，永远不要硬编码。Docker 网络按需配置，避免把开发端口直接暴露到公网。

§10 常见问题

Q1：ChatDev 2.0 和 1.0 的核心区别是什么？

1.0 是固定场景（模拟软件公司），角色和流程预定义。2.0 是通用编排平台——你用 YAML 定义任意角色和交互拓扑，平台负责调度执行。

Q2：怎么选工作流模板？

看任务类型：数据可视化 → data_visualization_*.yaml；3D 生成 → blender_*.yaml（需要本地装 Blender）；游戏开发 → GameDev_v1.yaml；文献调研 → deep_research_v1.yaml。没有匹配的模板就自己写一个。

Q3：前端连不上后端？

默认端口 6400 可能被占用。后端换端口：--port 6401，前端同步设置 VITE_API_BASE_URL=http://localhost:6401。

Q4：怎么自定义智能体行为？

在 YAML 配置里定义智能体的角色描述、可用工具和交互规则。参考 yaml_template/ 下的示例。

Q5：支持哪些 LLM？

任何兼容 OpenAI API 格式的提供商。在 .env 里配 API_KEY 和 BASE_URL 就行。

Q6：怎么调试工作流？

make validate-yamls 检查 YAML 语法。Web 控制台的 Launch 界面可以逐节点查看日志和中间产物。

§11 什么时候用、什么时候不用

ChatDev 2.0 适合的场景：

• 你想快速验证一个多智能体协作方案，不想从零写编排代码。
• 团队里有非开发者需要参与工作流设计和执行（Web 控制台）。
• 工作流模式相对固定，主要变化是输入数据不同（模板 + 实例分离）。
• 需要把多智能体能力嵌入到自动化流程里（Python SDK + OpenClaw）。

不太适合的场景：

• 智能体之间的交互逻辑非常复杂、需要大量条件分支和动态路由——YAML 的表达能力有上限。
• 你对延迟和吞吐有苛刻要求——ChatDev 的调度层增加了一层抽象开销。
• 你的工作流高度依赖某个特定框架的内部机制（如 LangGraph 的状态图、AutoGen 的对话模式）——ChatDev 是独立编排模型，迁移成本不低。

如果决定用，建议的采用顺序是：

1. 先跑 Demo：从 demo_*.yaml 开始，理解 YAML 结构和运行时行为。
2. 改模板：基于 Demo 模板改一个自己场景的简单版本，验证能跑通。
3. 上 SDK：需要批量或集成时，把流程切到 Python SDK。
4. 加自定义工具：在 functions/ 里写自己的工具函数，注册到工作流。
5. 考虑 OpenClaw：当需要把 ChatDev 工作流嵌入更大的自动化系统时，再引入 OpenClaw。

相关链接

文档版本 1.1 | 优化日期：2026-06-02 | 基于 ChatDev 2.0 (32.4k Stars, Apache-2.0)