Skip to content

zrxparley/leadbot-studio

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
app
app
 
 
docs/plans
docs/plans
 
 
tests
tests
 
 
.env.example
.env.example
 
 
.gitignore
.gitignore
 
 
README.md
README.md
 
 
pyproject.toml
pyproject.toml
 
 

Repository files navigation

LeadBot Studio

LeadBot Studio 是一个基于 OpenClaw 思路构建的多智能体工作室框架。

它的核心目标不是替代 OpenClaw Gateway，而是提供一个更高层的控制平面，让你可以围绕一个 LeadBot 去统一组织、配置、编排、治理多个 AgentBot，并把这些定义导出成 OpenClaw 友好的配置起点。

这个项目解决什么问题

当你要做一个真正可运营的多智能体工作室时，光有多个 agent 还不够。你通常还需要：

  • 一个可以代表工作室对外工作的 LeadBot
  • 多个职责清晰、可自定义的 AgentBot
  • workflow/flow 管理能力
  • AgentBot 的技能、备注、头像、能力、workspace、工具策略管理
  • OpenClaw 配置导出能力
  • 统一的治理能力：审批、handoff、A2A allowlist、审计要求

这就是 LeadBot Studio 的定位。

核心概念

1. LeadBot

LeadBot 是控制平面，不是网关替代品。

它负责：

  • 任务分解
  • workflow 选择
  • specialist agent 调度
  • 审批与升级
  • handoff 协议
  • 输出把关

2. AgentBot

每个 AgentBot 都可以独立定义：

  • id
  • role
  • objective
  • avatar
  • remark
  • workspace
  • skills
  • tool_policy
  • bindings
  • notes

3. Workflow

每个 workflow 都支持：

  • 指定 LeadBot
  • 指定参与的 AgentBot
  • 配置 step 顺序
  • 配置 step owner
  • 配置依赖关系
  • 配置 deliverables
  • 配置 handoff 目标
  • 配置审批点

当前已经实现的能力

  • FastAPI 控制平面
  • StudioManifest 配置模型
  • LeadBot / AgentBot / Workflow 领域模型
  • workflow plan 编译器
  • workflow dry-run、运行记录持久化、状态流转
  • operator console，可直接发起 run 并推进 run / step 状态
  • 低代码 builder console，可通过 Web UI 创建、编辑、删除 AgentBot / Workflow
  • Workflow Builder 可视化依赖编排，支持 step graph、依赖预览、拖拽排序
  • AgentBot Builder 模板系统，内置 Researcher / Developer / QA / Publisher 骨架
  • LeadBot 对话起草，可根据自然语言 brief 自动生成并接好 AgentBot / Workflow 草案
  • LeadBot 模型起草引擎，支持“模型优先，规则回退”
  • LeadBot 对话 refinement，可带着当前 draft 和对话历史继续用自然语言微调
  • LeadBot manifest impact diff，可预览新增 / 更新 / 删除哪些 AgentBot 与 Workflow
  • LeadBot workflow review，可预览 step 顺序、依赖、owner、approval gate 的具体变化
  • LeadBot execute 模式，可直接通过自然语言 Send & Apply 同步工作室
  • LeadBot proposal 审议链路，支持 approve / reject / revise
  • OpenClaw 配置导出器
  • 自动生成默认 studio manifest
  • 一个可直接 fork 的默认工作室模板
  • 独立 Agents 配置页 (/studio/agents-config)：Agent 富卡片列表、头像预览、技能标签、直接 Edit / Delete
  • Chat Vibe Coding 双栏工作台 (/studio/chat)：左栏多轮对话 + 右栏实时 Proposal Review 可视化（Mermaid workflow + manifest diff + 审批操作一体化）
  • Workflow Visual Editor (/studio/workflows)：独立工作流编辑页，拖拽排序 step，可视化 Mermaid graph，dry-run 和 dispatch 一体化
  • Model Integration：支持 OpenAI / Azure OpenAI / OpenAI-compatible 多 Provider，自动 fallback 到 deterministic
  • Agent Avatar Upload：支持上传头像图片（POST /studio/upload/avatar），存储在 app/data/avatars/
  • Proposal Notification：Navigation badge 显示 pending proposals 数量，30秒自动轮询更新

主要接口

  • GET /health
  • GET /studio/manifest
  • PUT /studio/manifest
  • GET /studio/summary
  • POST /studio/leadbot/draft
  • POST /studio/leadbot/execute
  • POST /studio/leadbot/proposals
  • GET /studio/leadbot/proposals
  • GET /studio/leadbot/proposals/{proposal_id}
  • POST /studio/leadbot/proposals/{proposal_id}/actions
  • POST /studio/leadbot/apply-draft
  • GET /studio/agents
  • GET /studio/workflows
  • GET /studio/workflows/{workflow_id}/plan
  • POST /studio/workflows/{workflow_id}/dry-run
  • POST /studio/workflows/{workflow_id}/runs
  • GET /studio/runs
  • GET /studio/runs/{run_id}
  • GET /studio/runs/{run_id}/events
  • PATCH /studio/runs/{run_id}
  • PATCH /studio/runs/{run_id}/steps/{step_id}
  • POST /studio/runs/{run_id}/dispatch (OpenClaw runtime bridge)
  • GET /studio/openclaw/export

项目结构

app/
  api/
  core/
  db/
  studio/
docs/plans/
tests/

本地启动

  1. 创建虚拟环境并安装依赖
python3 -m venv .venv
source .venv/bin/activate
pip install -e .[dev]
  1. 准备环境变量
cp .env.example .env

如果要启用模型驱动的 LeadBot draft，在 .env 中配置：

LEADBOT_DRAFT_PROVIDER=auto
LEADBOT_DRAFT_MODEL=gpt-5.4
OPENAI_API_KEY=your_key_here
OPENAI_BASE_URL=

不配置时，LeadBot 仍然可以工作，只是会退回内置的确定性起草器。

  1. 启动服务
uvicorn app.main:app --reload
  1. 打开默认文档
http://127.0.0.1:8000/docs

控制台首页：

http://127.0.0.1:8000/studio/console

首次访问 /studio/* 接口时，系统会自动生成默认 manifest：

app/data/leadbot_studio_manifest.json

默认工作室模板

项目内置了一套默认的工作室配置：

  • studio-lead
  • researcher
  • builder
  • qa
  • publisher

默认附带两个 workflow：

  • build-delivery
  • research-briefing

你可以直接修改 manifest，把 bot 的名字、头像、技能、工作流、交付方式替换成你自己的工作室配置。

现在也可以直接在 /studio/console 里和 LeadBot 对话，例如：

  • 我想做一个产品发布工作室，LeadBot 统筹，研究员负责素材，发布 Agent 负责多渠道分发。
  • 把 QA 改成只在最终交付前介入。
  • 再加一个运营 Agent，专门做上线后的复盘和数据回收。

控制台现在支持两种节奏：

  • Send to LeadBot：先起草，再看 impact diff，然后决定是否应用
  • Send & Apply：直接把这句自然语言变成 studio 变更并同步到 manifest

同时也提供独立入口：

  • /studio/chat
  • /studio/workflows
  • /studio/proposals

配置文件现在默认从项目根目录 .env 读取；如果部署时配置文件不在仓库根目录，可以通过环境变量 LEADBOT_ENV_FILE 指向自定义配置文件路径。

OpenClaw 对接思路

这个项目遵循一个原则：

  • OpenClaw 负责 agent 隔离、bindings、channel routing、runtime
  • LeadBot Studio 负责 orchestration、workflow management、governance、export

也就是说，LeadBot Studio 更像是 OpenClaw 之上的“工作室操作系统”。

设计文档

详细设计在：

docs/plans/2026-04-16-leadbot-studio-design.md

本轮关于模型起草和自然语言 vibe drafting 的设计补充在：

docs/plans/2026-04-17-leadbot-vibe-drafting-design.md

整体 roadmap 在：

docs/plans/2026-04-16-leadbot-studio-roadmap.md

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages