Builder Agent

概述

自动生成安全工具和DevOps实用程序的开发代理。ChatDev 2.0的7个代理协同工作，实现从需求分析到部署的全流程自动化。

自修正循环：发生错误时自动修正并重试（最多3次）

工作流程

创意发掘（GitHub Trending、CVE、安全新闻）
↓
Notion队列注册（创意数据库）
↓
ChatDev 2.0开发（7个代理协同）
├─ CEO：需求分析
├─ CPO：产品规划
├─ CTO：架构设计
├─ Programmer：代码生成
├─ Reviewer：代码审查
├─ Tester：测试生成
└─ CTO Final：最终验证
↓
自动测试执行
↓
发生错误？→ 修正 → 重试（最多3次）
↓
GitHub仓库创建并部署

主要功能

1. 创意发掘（Discovery）

• - GitHub Trending：分析热门项目
• CVE数据库：基于最新漏洞的工具
• 安全新闻：基于安全新闻的实用程序
• Notion队列：自动注册创意

2. ChatDev 2.0开发（Development）

7个代理协同：

代理	角色	负责任务
CEO	首席执行官	需求分析、方向决策
CPO

首席产品官 | 产品规划、功能定义 | | CTO | 首席技术官 | 架构设计、技术栈决策 | | Programmer | 开发者 | 代码生成、实现 | | Reviewer | 审查者 | 代码审查、质量验证 | | Tester | 测试者 | 测试代码编写、执行 | | CTO Final | 最终审查者 | 最终验证、部署批准 |

3. 自修正循环（Self-Correction）

测试执行
↓
发现错误
↓
错误分析 → 制定修正方案
↓
代码修正
↓
重新测试
↓
成功？→ 部署 / 失败？→ 重试（最多3次）

4. GitHub自动部署（Publishing）

• - 仓库创建：自动创建GitHub仓库
• 代码上传：自动推送完成代码
• README生成：自动文档化
• 发布创建：自动发布v1.0.0

安装方法

1. 克隆仓库

bash git clone --recursive https://github.com/rebugui/OpenClaw.git cd OpenClaw/submodules/builder-agent

2. ChatDev 2.0设置

bash cd ../chatdev-v2 python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate pip install -r requirements.txt

3. 安装依赖

bash cd ../builder-agent pip install -r requirements.txt

4. 设置环境变量

bash cp .env.example .env

修改.env文件：
bash

GLM API（智谱AI）

GLMAPIKEY=yourglmapi_key
GLMBASEURL=https://api.z.ai/api/coding/paas/v4

GitHub

GITHUBTOKEN=yourgithub_token GITHUBUSERNAME=yourusername

Notion

NOTIONAPIKEY=yournotionapi_key NOTIONDATABASEID=yourdatabaseid

ChatDev

CHATDEV_URL=http://localhost:6400

5. 启动ChatDev服务器

bash cd ../chatdev-v2 python server_main.py --port 6400

API: http://localhost:6400

使用方法

手动执行

1. 创意发掘

bash python main.py discovery

2. 开发执行

bash

从Notion队列获取创意进行开发

python main.py develop

开发特定项目

python main.py develop --project cve-scanner

3. 队列监控

bash python queue_monitor.py

注册调度器

注册到OpenClaw调度器以自动执行：

yaml

config.yaml

jobs:
# 创意发掘（每天08:00、20:00）
- id: builder_discovery
name: Builder Discovery - 每天上午8点/下午8点创意发掘
enabled: true
module: submodules.builder-agent.main
class: BuilderAgentV3
method: run_discovery
trigger:
type: cron
dayofweek: mon-sun
hour: 8,20
minute: 0

# 开发队列处理（每6小时）
- id: builderqueueprocessor
name: Builder Queue Processor - 每6小时处理开发/改进队列
enabled: true
module: submodules.builder-agent.main
class: BuilderAgentV3
method: rundevelopmentfrom_notion
trigger:
type: interval
hours: 6

# 队列监控（每6小时）
- id: builderqueuemonitor
name: Builder Queue Monitor - 每6小时检查队列状态并通知
enabled: true
module: modules.builder.queue_monitor
function: main
trigger:
type: interval
hours: 6

配置文件

config.yaml

yaml discovery: sources: - github_trending - cve_database - security_news max_ideas: 5 keywords: - vulnerability - scanner - automation

development:
max_retries: 3
test_timeout: 300
output_dir: ./projects

chatdev:
url: http://localhost:6400
model: glm-5
timeout: 1800

github:
auto_publish: true
private: false
license: MIT

文件结构

builder-agent/
├── main.py # 主执行文件
├── config.yaml # 配置文件
├── .env.example # 环境变量示例
├── requirements.txt # 依赖
│
├── discoverer/ # 创意发掘
│ ├── github_trending.py
│ ├── cve_analyzer.py
│ └── news_monitor.py
│
├── orchestrator/ # 开发编排
│ ├── chatdev_client.py
│ ├── test_runner.py
│ └── github_publisher.py
│
├── improvement/ # 改进系统
│ └── improvement_pipeline.py
│
├── models/ # 数据模型
│ └── project.py
│
└── logs/ # 日志
└── builder.log

Notion数据库设置

创意数据库

• - Title（标题）
• Status（选项：Idea、Developing、Testing、Completed、Failed）
• Priority（选项：High、Medium、Low）
• Source（选项：GitHub、CVE、News）
• Created（创建日期）
• Repository（URL）

示例项目

已生成的项目

1. 1. secure_app - 安全设置自动化工具
2. cve-scanner-v2 - CVE漏洞扫描器
3. file-integrity-monitor - 文件完整性监控

项目结构

cve-scanner-v2/
├── README.md
├── requirements.txt
├── setup.py
├── src/
│ ├── init.py
│ ├── main.py
│ └── utils.py
└── tests/
├── init.py
└── test_main.py

成功/失败记录

成功项目（2026-02-22 ~ 2026-02-23）

1. 1. secure_app ✅（2026-02-22 18:08）
2. cve-scanner-v2 ✅（2026-02-23 12:17）
3. cve-scanner-v6 ✅（2026-02-23 13:41）
4. cve-scanner-v7 ✅（2026-02-23 13:46）
5. cve-scanner-v8 ✅（2026-02-23 14:10）

失败项目

1. 1. file-integrity-monitor ❌ - 测试失败
2. cve-scanner-v3 ❌ - 测试失败
3. cve-scanner-v5 ❌ - 测试失败

常见问题：测试代码与实现逻辑不匹配 → 需要改进提示