
这是一个基于OpenClaw框架的多Agent协作系统,将中国古代的三省六部制度应用于AI团队管理,实现了可观测、可审计、可干预的AI协作流程。
项目的概述
项目定位:这是一个开箱即用的多Agent协作系统,将AI Agent组织成类似古代朝廷的行政体系,用户作为"皇帝"下达指令,AI作为"大臣"各司其职执行任务。
核心价值:解决传统多Agent框架"自由对话"导致的四大问题:质量不可控、过程不可审计、执行不可干预、责任不可归因。通过制度化的分权制衡机制,确保每个任务都必须经过审核才能进入执行阶段。
系统架构
12个Agent的完整分工
| 部门/角色 | Agent ID | 核心职责 | 擅长领域 |
|---|---|---|---|
| 太子 | taizi | 消息分拣、需求整理 | 闲聊识别、旨意提炼 |
| 中书省 | zhongshu | 接旨、方案规划、子任务拆解 | 需求理解、任务分解 |
| 门下省 | menxia | 方案审议、质量把关、不合格封驳 | 质量评审、风险识别 |
| 尚书省 | shangshu | 任务派发、跨部门协调、结果汇总 | 任务调度、进度跟踪 |
| 户部 | hubu | 数据处理、资源核算、报表生成 | 数据分析、成本核算 |
| 礼部 | libu | 文档撰写、规范制定、报告输出 | 技术文档、内容创作 |
| 兵部 | bingbu | 代码开发、算法实现、代码审查 | 功能开发、Bug修复 |
| 刑部 | xingbu | 安全扫描、合规审计、红线管控 | 安全检测、合规检查 |
| 工部 | gongbu | 部署配置、CI/CD、工具开发 | Docker配置、自动化运维 |
| 吏部 | libu_hr | Agent管理、权限维护、配置同步 | Agent注册、权限管理 |
| 早朝官 | zaochao | 每日早朝、新闻聚合、定时播报 | 资讯采集、数据汇总 |
三种制度模式选择
系统提供三种不同的制度模式供选择:
- 明朝内阁制(默认):司礼监 + 内阁 + 六部,快速迭代,适合个人项目(18个Agent)
- 唐朝三省制:中书→门下→尚书,制衡审核,适合偏好严谨流程的项目(14个Agent)
- 现代企业制:CEO/CTO/CFO,国际化,适合创业团队(14个Agent)
核心功能特点
1. 强制审核机制
门下省是架构的核心环节,每个任务方案都必须经过审核,不合格直接打回重做。这是与其他框架最大的区别,传统框架如CrewAI、AutoGen等要么没有审核机制,要么需要人工介入。
2. 实时可视化看板(军机处)
内置10个功能面板:
- 旨意看板Kanban:按状态列展示任务,支持省部过滤+搜索
- 省部调度Monitor:可视化任务分布,Agent健康状态
- 奏折阁Memorials:已完成任务归档,五阶段时间线
- 官员总览Officials:Token消耗排行,活跃度统计
- 天下要闻News:自动采集科技/财经资讯
- 模型配置Models:每个Agent独立切换LLM
- 技能配置Skills:查看和添加技能
- 小任务Sessions:会话实时监控
3. 任务实时干预
用户可以在看板中随时叫停、取消、恢复任务,避免AI跑偏后无法控制的问题。
4. 全流程流转审计
完整的奏折存档,五阶段时间线可追溯,所有决策和执行过程都有完整记录。
5. 模型热切换
看板内一键切换各Agent的LLM模型,支持Anthropic、OpenAI、Gemini、DeepSeek等多种模型。
完整部署指南
前提条件
- OpenClaw已安装并运行
- Python 3.9+
- macOS/Linux(Windows需WSL2)
- Node.js 18+(前端构建,可选)
三种安装方式
方式一:本地安装(推荐)
bash
git clone https://github.com/wanikua/danghuangshang.git
cd danghuangshang
bash scripts/full-install.sh
优点:可离线使用,可修改安装脚本,可查看所有文件,包含完整人设注入。
方式二:远程一键安装
Linux/macOS:
bash
bash <(curl -fsSL https://raw.githubusercontent.com/wanikua/danghuangshang/main/scripts/full-install.sh)
Windows (PowerShell):
powershell
powershell -ExecutionPolicy Bypass -File (New-Object Net.WebClient).DownloadString('https://raw.githubusercontent.com/wanikua/danghuangshang/main/install.ps1')
优点:无需git,复制粘贴一行命令,包含完整人设注入。
方式三:已有OpenClaw的简化版
bash
bash <(curl -fsSL https://raw.githubusercontent.com/wanikua/danghuangshang/main/install-lite.sh)
适用:已安装OpenClaw,只需配置模板。包含人设注入。
配置与启动步骤
-
选择制度:安装时会提示选择明朝内阁制、唐朝三省制或现代企业制
-
填写配置:按提示填入LLM API Key + Discord Bot Token
-
启动服务 :
bash# 终端1:数据刷新循环 bash scripts/run_loop.sh # 终端2:看板服务器 python3 dashboard/server.py -
访问看板 :打开浏览器访问
http://127.0.0.1:7891 -
开始使用:在Discord @你的Bot说话即可开始下达指令
Docker快速体验
如果不想折腾完整安装,可以使用Docker快速体验:
bash
docker run -p 7891:7891 cft0808/edict
打开 http://localhost:7891 即可体验完整看板。
首次验收清单
安装完成后,请检查以下地址确保系统正常运行:
- 看板:
http://127.0.0.1:7891 - 健康检查:
http://127.0.0.1:7891/healthz - 实时状态:
http://127.0.0.1:7891/api/live-status - 后端文档:
http://127.0.0.1:8000/docs - Gateway:
http://127.0.0.1:18789
使用流程示例
以"设计一个FastAPI用户注册系统"为例:
- 皇帝下旨:用户下达任务需求
- 太子分拣:判断是正式旨意,创建任务
- 中书省规划:拆解成子任务(API设计、数据库设计、测试用例等)
- 门下省审核:审核方案,不合格直接封驳
- 尚书省调度:派发给兵部(代码开发)、工部(部署)、礼部(文档)
- 六部并行执行:各部同时开展工作
- 汇总回奏:尚书省汇总各部门成果,形成最终报告
配置需要注意
重要安全提示:
- 严禁使用
@everyone:会触发所有Bot同时响应,导致频道瘫痪 - 每个Bot都要开启Message Content Intent + Server Members Intent(Discord Developer Portal→Bot页面→Privileged Gateway Intents)
- 多Bot模式下,必须在每个Agent的
openclaw.json中设置allowBots: "mentions"
费用估算
根据官方信息,轻度使用每月约10-15,中度使用约20-30。建议重活用强模型、轻活用快模型,可节省5倍成本。