在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 快速体验（最快上手）

这是最快捷的体验方式，适合想要快速感受项目核心功能的用户。

  1. 环境准备：确保你的 Ubuntu/Linux 系统已安装 Docker。

  2. 运行容器：在终端中直接执行以下命令，即可拉取镜像并启动服务。

     docker run -p 7891:7891 cft0808/edict

  3. 访问验证：服务启动后，在浏览器中访问 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。

  1. 为“太子”配置 API Key：在终端中执行以下命令，为 taizi (太子) 角色配置 API Key： 
        openclaw agents add taizi

在这里插入图片描述

命令执行后，终端会进入一个交互式的配置流程，请根据提示进行操作：

- **选择模型提供商**：我这里选择的是deepseek，大家模型可以自行选择
    
- **输入 API Key**：从你的模型提供商账户中获取 API Key，并在此处粘贴。

  1. 将 API Key 同步给所有“百官”：配置完成后，重新运行安装脚本，它会将 API Key 同步给其他10位“大臣”。

    ./install.sh

    脚本执行过程中，你会看到 ✅ API Key 已同步到 11 个 Agent 的提示信息。

  2. 重启“朝廷”服务 (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“朝廷”。

# github # 开源 # 人工智能
Logo
AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

cover

当 SpringBoot 请求踏上“七层之旅”：OSI 模型与你的每一行代码

avatar AtomGit开源社区
cover

元宇宙对技术行业的影响：新机遇与新挑战

avatar AtomGit开源社区
cover

C++17新特性：结构化绑定/inline变量/if相关的变化

avatar AtomGit开源社区