在AI多Agent的使用过程中，很多小伙伴应该都遇到过类似的困扰：要么Agent协作乱成一团，要么做完没有审核，出了问题还找不到原因。比如CrewAI里的Agent自主协作缺乏管控，输出结果常常让人摸不着头脑；AutoGen虽然灵活，但任务执行过程没法追溯，出了错都不知道该找谁“背锅”。今天就给大家推荐一款超有意思的GitHub开源项目——edict
一、项目介绍
“三省六部·Edict”是一个基于OpenClaw的多智能体系统，其核心设计理念源自中国古代的“三省六部制。
-
🤖 12个AI智能体 (Agent)：项目设计了12个各有分工的AI智能体，模拟了从决策、审议到执行的全套官僚体系，确保复杂任务能够有条不紊地处理。
-
⚖️ 分权制衡的架构：核心流程为“皇上（你）→ 太子（分拣）→ 中书省（规划）→ 门下省（审议）→ 尚书省（派发）→ 六部（执行）→ 回奏”。其中“门下省”的强制审核是其最大特色，能有效防止任务“带病执行”，提升了最终产出的可靠性。
-
🖥️ 功能强大的看板：配套的“军机处”看板提供任务看板、实时监控、模型切换和完整审计日志等功能，让你能对任务流转的全过程了如指掌。
二、项目结构拆解
edict/
├── agents/ # 12个Agent的“人格配置中心”（核心部分）
│ ├── taizi/SOUL.md # 太子Agent：区分闲聊和正式任务，不瞎忙活
│ ├── zhongshu/SOUL.md # 中书省Agent：接任务、做规划、拆细节
│ ├── menxia/SOUL.md # 门下省Agent：专门审核，不合格就打回
│ ├── shangshu/SOUL.md # 尚书省Agent：调度六部，汇总任务结果
│ ├── hubu/SOUL.md # 户部Agent：管数据、算成本、出报表
│ ├── libu/SOUL.md # 礼部Agent：写文档、定规范（比如博客、报告）
│ ├── bingbu/SOUL.md # 兵部Agent：写代码、做工程、查Bug
│ ├── xingbu/SOUL.md # 刑部Agent：做安全审计、查合规
│ ├── gongbu/SOUL.md # 工部Agent：搞部署、装Docker、做自动化
│ ├── libu_hr/ # 吏部Agent：管Agent的权限和“人事”
│ └── zaochao/SOUL.md # 早朝官Agent：每天聚合新闻，还能推送
├── dashboard/ # 军机处看板相关文件（可视化核心）
│ ├── dashboard.html # 看板前端页面（单文件，不用额外装依赖）
│ └── server.py # 看板后端服务器（基于Python标准库，零依赖）
├── scripts/ # 辅助脚本目录，启动和维护项目会用到
│ ├── run_loop.sh # 数据刷新脚本，每15秒同步一次看板数据
│ └── skill_manager.py # Agent技能管理脚本，添加、更新技能用
├── data/ # 项目运行时数据目录（重点：不存生成的文件！）
├── docs/ # 官方文档目录，遇到问题可以查这里
├── install.sh # 一键安装脚本，新手救星，简化部署
└── 其他配置文件 # 项目基础配置，安装脚本会自动处理，不用管
三、安装Edict项目
方案一：Docker 快速体验（最快上手）
这是最快捷的体验方式，适合想要快速感受项目核心功能的用户。
环境准备：确保你的 Ubuntu/Linux 系统已安装 Docker。
运行容器：在终端中直接执行以下命令，即可拉取镜像并启动服务。
docker run -p 7891:7891 cft0808/edict
访问验证：服务启动后，在浏览器中访问 http://127.0.0.1:7891，即可看到项目看板。你也可以访问 http://127.0.0.1:7891/healthz 来检查服务的健康状态。
方案二：源码安装（适合开发与深度使用）
项目安装前置条件
- OpenClaw Linux或者Ubuntu里需要提前安装
- Python 3.9+ ：部分后端服务依赖Python环境
- macOS / Linux
- Node.js：推荐使用最新稳定版（如v20+），项目运行的基础。
- Git：用于克隆项目代码
环境就绪检查清单
所有软件都安装完毕后，可以运行以下命令做一个最终的检查：
| Git | git –version |
| Python | python3.12 –version |
| Node.js | node –version |
| npm | npm –version |
| Docker | docker –version |
所有依赖都准备好之后，就可以继续部署Edict项目了。下面的命令会克隆项目代码、进入目录、运行安装脚本，并启动服务：
1. 克隆项目仓库
git clone https://github.com/cft0808/edict.git
这里克隆容易超时失败，博主推荐这里使用这个GitHub加速下载代理，它可以解决 GitHub 资源访问慢、下载失败、直连受限等问题 GitHub加速下载代理
2. 进入项目目录
cd edict
3. 给安装脚本添加执行权限并运行
./install.sh chmod +x install.sh && ./install.sh
可以看到我们安装成功
安装完成后我们第一步就是配置 API Key
项目中的“百官”（AI Agent们）要“思考和办公”，需要一个AI大脑，而 API Key 就是接入这个大脑的“官印”。你只需为“太子”这一个角色配置即可，项目内置的同步机制会自动将它复制给所有 Agent。
命令执行后，终端会进入一个交互式的配置流程，请根据提示进行操作：
– **选择模型提供商**：我这里选择的是deepseek，大家模型可以自行选择
– **输入 API Key**：从你的模型提供商账户中获取 API Key，并在此处粘贴。
将 API Key 同步给所有“百官”：配置完成后，重新运行安装脚本，它会将 API Key 同步给其他10位“大臣”。
./install.sh
脚本执行过程中，你会看到 ✅ API Key 已同步到 11 个 Agent 的提示信息。
重启“朝廷”服务 (Gateway)：为了让新的 API Key 配置生效，需要重启 OpenClaw 的核心服务。
sudo systemctl restart openclaw-gateway.service
💡 小提示：你也可以通过将 API Key 写入环境变量文件 ~/.openclaw/.env 的方式进行配置，这对于服务器环境下的自动化部署会更方便。
4. 启动数据同步脚本
终端 1：启动数据刷新循环 这个服务负责实时同步各Agent的状态和数据，是看板动态更新的基础。
cd ~/edict
bash scripts/run_loop.sh
你会看到类似 每 15 秒自动同步 OpenClaw 运行时数据到看板 的提示，表明服务已正常启动。
5. 启动看板服务
终端 2：启动可视化看板 (再开一个终端) 这个服务会启动一个Web界面，让你能直观地“围观”整个协作过程。
# 终端 2：看板服务器
cd ~/edict
python3 dashboard/server.py
等待终端显示服务器启动成功的日志后，你就可以在浏览器中访问 http://127.0.0.1:7891 进入“军机处”看板了。 
服务启动后，在浏览器里访问 http://127.0.0.1:7891 就能看到项目的看板界面了。 或者通过命令行
# 打开浏览器
open http://127.0.0.1:7891
如果在安装过程中遇到任何问题，随时把错误信息贴出来，我帮你看看。
接下来就可以赛博”议政“了 
现在，你就可以像古代的“皇上”一样下旨了！（小声bb一下，可能会有点费token哦）
-
下达任务：在看板界面中找到输入框，输入你的需求（即“旨意”），例如：“帮我规划一次北京三日游的行程”。
-
围观“朝会”：任务提交后，看板会以可视化的方式，实时展示“旨意”在“太子”、“中书省”、“门下省”等各个“部门”间的流转和“处理”过程。你可以清晰地看到每个环节的输入、输出以及思考过程。
-
使用“兵部”进行代码审查（可选）：如果需要审查代码，可以将代码片段作为旨意内容下达，并指定由“兵部”（bingbu）处理，它会执行代码审查任务。
-
使用“工部”进行部署（可选）：如果需要部署应用，可以下达旨意给“工部”（gongbu），它会负责执行CI/CD等部署相关任务。
项目生成出来的文件如果找不到可以在以下目录寻找 /home/explore/.openclaw/workspace-taizi 
故障排查
如果在上述步骤中遇到问题，可以参考下面的排查建议：
| openclaw: command not found | 环境变量未更新。执行 source ~/.bashrc 刷新当前终端的环境变量。 |
| openclaw agents add taizi 命令报错 | Gateway 服务未运行。尝试使用 sudo systemctl restart openclaw-gateway.service 重启服务。 |
| API Key 配置失败 | Key无效或网络问题。请仔细核对API Key是否正确，并确保网络能够正常访问你的模型提供商API。 |
| 看板无法访问 | 端口被占用或服务未启动。检查 python3 dashboard/server.py 是否运行，或尝试更换端口。 |
| 数据不刷新 | 刷新循环未运行。检查 bash scripts/run_loop.sh & 是否在运行，或手动执行一次 python scripts/refresh_live_data.py 测试。 |
总结
“三省六部·Edict”项目以其独特的创意，为AI多智能体协作提供了一个新颖且强大的框架。希望这份部署指南能帮助你顺利启动这个有趣的“赛博朝廷”，探索AI协作的更多可能性。
如果在部署中遇到任何问题，建议先查阅项目GitHub仓库的README和文档，那里通常有最及时的解决方案。
希望这份“上手指南”能帮你顺利启动这个别具一格的AI“朝廷”。
